Create a self-hosted runner group for an enterprise

POST

/enterprises/{enterprise}/actions/runner-groups

Creates a new self-hosted runner group for an enterprise.

You must authenticate using an access token with the admin:enterprise scope to use this endpoint.

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.github.com/enterprises//actions/runner-groups' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Expensive hardware runners",
    "runners": [
        9,
        2
    ],
    "selected_organization_ids": [
        32,
        91
    ],
    "visibility": "selected"
}'

响应示例

{
    "allows_public_repositories": true,
    "default": true,
    "id": 0,
    "name": "string",
    "runners_url": "string",
    "selected_organizations_url": "string",
    "visibility": "string"
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

enterprise

string

必需

The slug version of the enterprise name. You can also substitute this value with the enterprise id.

Body 参数application/json

name

string

必需

Name of the runner group.

runners

array[integer]

可选

List of runner IDs to add to the runner group.

selected_organization_ids

array[integer]

可选

List of organization IDs that can access the runner group.

visibility

enum<string>

可选

Visibility of a runner group. You can select all organizations or select individual organization. Can be one of: all or selected

枚举值:

selectedall

示例

返回响应

🟢201Response

application/json

Body

allows_public_repositories

boolean

必需

default

boolean

必需

number

必需

name

string

必需

runners_url

string

必需

selected_organizations_url

string

可选

visibility

string

必需

修改于 2022-08-24 13:05:02

List self-hosted runner groups for an enterprise

Delete a self-hosted runner group from an enterprise