자체 호스팅 실행기
REST API를 사용하여 GitHub Actions에서 자체 호스팅 실행기와 상호 작용합니다.
GitHub Actions의 자체 호스팅 실행기 정보
REST API를 사용하여 GitHub Actions에서 자체 호스팅 실행기를 등록, 보기 및 삭제할 수 있습니다. 자체 호스트 실행기를 사용하면 사용자 고유의 실행기를 호스트하고 GitHub Actions 워크플로에서 작업을 실행하는 데 사용되는 환경을 사용자 지정할 수 있습니다. 자세한 내용은 “자체 실행기 호스트”를 참조하세요.
이러한 엔드포인트는 인증된 사용자, OAuth Apps, GitHub Apps에 사용할 수 있습니다. 액세스 토큰을 사용하려면 프라이빗 리포지토리의 경우 repo 범위가, 내부 리포지토리의 경우 public_repo 범위가 필요합니다. GitHub Apps에는 administration 조직에 대한 리포지토리 organization_self_hosted_runners 사용 권한이 있어야 합니다. 인증된 사용자는 리포지토리 또는 조직에 대한 관리자 액세스 권한 또는 엔터프라이즈에서 manage_runners:enterprise 이러한 엔드포인트를 사용할 수 있는 범위가 있어야 합니다.
List self-hosted runners for an enterprise
Lists all self-hosted runners configured for an enterprise.
You must authenticate using an access token with the admin:enterprise scope to use this endpoint.
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
enterprisestring필수The slug version of the enterprise name. You can also substitute this value with the enterprise id. |
| 쿼리 매개 변수 |
| 이름, 형식, 설명 |
per_pageintegerThe number of results per page (max 100). 기본값: |
pageintegerPage number of the results to fetch. 기본값: |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
200 | OK |
코드 샘플
curl \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/enterprises/ENTERPRISE/actions/runnersResponse
Status: 200{
"total_count": 2,
"runners": [
{
"id": 23,
"name": "linux_runner",
"os": "linux",
"status": "online",
"busy": true,
"labels": [
{
"id": 5,
"name": "self-hosted",
"type": "read-only"
},
{
"id": 7,
"name": "X64",
"type": "read-only"
},
{
"id": 11,
"name": "Linux",
"type": "read-only"
}
]
},
{
"id": 24,
"name": "mac_runner",
"os": "macos",
"status": "offline",
"busy": false,
"labels": [
{
"id": 5,
"name": "self-hosted",
"type": "read-only"
},
{
"id": 7,
"name": "X64",
"type": "read-only"
},
{
"id": 20,
"name": "macOS",
"type": "read-only"
},
{
"id": 21,
"name": "no-gpu",
"type": "custom"
}
]
}
]
}List runner applications for an enterprise
Lists binaries for the runner application that you can download and run.
You must authenticate using an access token with the admin:enterprise scope to use this endpoint.
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
enterprisestring필수The slug version of the enterprise name. You can also substitute this value with the enterprise id. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
200 | OK |
코드 샘플
curl \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/enterprises/ENTERPRISE/actions/runners/downloadsResponse
Status: 200[
{
"os": "osx",
"architecture": "x64",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-osx-x64-2.164.0.tar.gz",
"filename": "actions-runner-osx-x64-2.164.0.tar.gz"
},
{
"os": "linux",
"architecture": "x64",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-linux-x64-2.164.0.tar.gz",
"filename": "actions-runner-linux-x64-2.164.0.tar.gz"
},
{
"os": "linux",
"architecture": "arm",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-linux-arm-2.164.0.tar.gz",
"filename": "actions-runner-linux-arm-2.164.0.tar.gz"
},
{
"os": "win",
"architecture": "x64",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-win-x64-2.164.0.zip",
"filename": "actions-runner-win-x64-2.164.0.zip"
},
{
"os": "linux",
"architecture": "arm64",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-linux-arm64-2.164.0.tar.gz",
"filename": "actions-runner-linux-arm64-2.164.0.tar.gz"
}
]Create a registration token for an enterprise
Returns a token that you can pass to the config script. The token expires after one hour.
You must authenticate using an access token with the admin:enterprise scope to use this endpoint.
Example using registration token
Configure your self-hosted runner, replacing TOKEN with the registration token provided by this endpoint.
./config.sh --url https://github.com/enterprises/octo-enterprise --token TOKEN
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
enterprisestring필수The slug version of the enterprise name. You can also substitute this value with the enterprise id. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
201 | Created |
코드 샘플
curl \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/enterprises/ENTERPRISE/actions/runners/registration-tokenResponse
Status: 201{
"token": "LLBF3JGZDX3P5PMEXLND6TS6FCWO6",
"expires_at": "2020-01-22T12:13:35.123-08:00"
}Create a remove token for an enterprise
Returns a token that you can pass to the config script to remove a self-hosted runner from an enterprise. The token expires after one hour.
You must authenticate using an access token with the admin:enterprise scope to use this endpoint.
Example using remove token
To remove your self-hosted runner from an enterprise, replace TOKEN with the remove token provided by this
endpoint.
./config.sh remove --token TOKEN
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
enterprisestring필수The slug version of the enterprise name. You can also substitute this value with the enterprise id. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
201 | Created |
코드 샘플
curl \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/enterprises/ENTERPRISE/actions/runners/remove-tokenResponse
Status: 201{
"token": "AABF3JGZDX3P5PMEXLND6TS6FCWO6",
"expires_at": "2020-01-29T12:13:35.123-08:00"
}Get a self-hosted runner for an enterprise
Gets a specific self-hosted runner configured in an enterprise.
You must authenticate using an access token with the admin:enterprise scope to use this endpoint.
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
enterprisestring필수The slug version of the enterprise name. You can also substitute this value with the enterprise id. |
runner_idinteger필수Unique identifier of the self-hosted runner. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
200 | OK |
코드 샘플
curl \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/enterprises/ENTERPRISE/actions/runners/RUNNER_IDResponse
Status: 200{
"id": 23,
"name": "MBP",
"os": "macos",
"status": "online",
"busy": true,
"labels": [
{
"id": 5,
"name": "self-hosted",
"type": "read-only"
},
{
"id": 7,
"name": "X64",
"type": "read-only"
},
{
"id": 20,
"name": "macOS",
"type": "read-only"
},
{
"id": 21,
"name": "no-gpu",
"type": "custom"
}
]
}Delete a self-hosted runner from an enterprise
Forces the removal of a self-hosted runner from an enterprise. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.
You must authenticate using an access token with the admin:enterprise scope to use this endpoint.
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
enterprisestring필수The slug version of the enterprise name. You can also substitute this value with the enterprise id. |
runner_idinteger필수Unique identifier of the self-hosted runner. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
204 | No Content |
코드 샘플
curl \
-X DELETE \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/enterprises/ENTERPRISE/actions/runners/RUNNER_IDResponse
Status: 204List self-hosted runners for an organization
Lists all self-hosted runners configured in an organization.
You must authenticate using an access token with the admin:org scope to use this endpoint.
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
orgstring필수The organization name. The name is not case sensitive. |
| 쿼리 매개 변수 |
| 이름, 형식, 설명 |
per_pageintegerThe number of results per page (max 100). 기본값: |
pageintegerPage number of the results to fetch. 기본값: |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
200 | OK |
코드 샘플
curl \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/orgs/ORG/actions/runnersResponse
Status: 200{
"total_count": 2,
"runners": [
{
"id": 23,
"name": "linux_runner",
"os": "linux",
"status": "online",
"busy": true,
"labels": [
{
"id": 5,
"name": "self-hosted",
"type": "read-only"
},
{
"id": 7,
"name": "X64",
"type": "read-only"
},
{
"id": 11,
"name": "Linux",
"type": "read-only"
}
]
},
{
"id": 24,
"name": "mac_runner",
"os": "macos",
"status": "offline",
"busy": false,
"labels": [
{
"id": 5,
"name": "self-hosted",
"type": "read-only"
},
{
"id": 7,
"name": "X64",
"type": "read-only"
},
{
"id": 20,
"name": "macOS",
"type": "read-only"
},
{
"id": 21,
"name": "no-gpu",
"type": "custom"
}
]
}
]
}List runner applications for an organization
Lists binaries for the runner application that you can download and run.
You must authenticate using an access token with the admin:org scope to use this endpoint.
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
orgstring필수The organization name. The name is not case sensitive. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
200 | OK |
코드 샘플
curl \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/orgs/ORG/actions/runners/downloadsResponse
Status: 200[
{
"os": "osx",
"architecture": "x64",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-osx-x64-2.164.0.tar.gz",
"filename": "actions-runner-osx-x64-2.164.0.tar.gz"
},
{
"os": "linux",
"architecture": "x64",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-linux-x64-2.164.0.tar.gz",
"filename": "actions-runner-linux-x64-2.164.0.tar.gz"
},
{
"os": "linux",
"architecture": "arm",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-linux-arm-2.164.0.tar.gz",
"filename": "actions-runner-linux-arm-2.164.0.tar.gz"
},
{
"os": "win",
"architecture": "x64",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-win-x64-2.164.0.zip",
"filename": "actions-runner-win-x64-2.164.0.zip"
},
{
"os": "linux",
"architecture": "arm64",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-linux-arm64-2.164.0.tar.gz",
"filename": "actions-runner-linux-arm64-2.164.0.tar.gz"
}
]Create a registration token for an organization
Returns a token that you can pass to the config script. The token expires after one hour.
You must authenticate using an access token with the admin:org scope to use this endpoint.
Example using registration token
Configure your self-hosted runner, replacing TOKEN with the registration token provided by this endpoint.
./config.sh --url https://github.com/octo-org --token TOKEN
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
orgstring필수The organization name. The name is not case sensitive. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
201 | Created |
코드 샘플
curl \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/orgs/ORG/actions/runners/registration-tokenResponse
Status: 201{
"token": "LLBF3JGZDX3P5PMEXLND6TS6FCWO6",
"expires_at": "2020-01-22T12:13:35.123-08:00"
}Create a remove token for an organization
Returns a token that you can pass to the config script to remove a self-hosted runner from an organization. The token expires after one hour.
You must authenticate using an access token with the admin:org scope to use this endpoint.
Example using remove token
To remove your self-hosted runner from an organization, replace TOKEN with the remove token provided by this
endpoint.
./config.sh remove --token TOKEN
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
orgstring필수The organization name. The name is not case sensitive. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
201 | Created |
코드 샘플
curl \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/orgs/ORG/actions/runners/remove-tokenResponse
Status: 201{
"token": "AABF3JGZDX3P5PMEXLND6TS6FCWO6",
"expires_at": "2020-01-29T12:13:35.123-08:00"
}Get a self-hosted runner for an organization
Gets a specific self-hosted runner configured in an organization.
You must authenticate using an access token with the admin:org scope to use this endpoint.
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
orgstring필수The organization name. The name is not case sensitive. |
runner_idinteger필수Unique identifier of the self-hosted runner. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
200 | OK |
코드 샘플
curl \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/orgs/ORG/actions/runners/RUNNER_IDResponse
Status: 200{
"id": 23,
"name": "MBP",
"os": "macos",
"status": "online",
"busy": true,
"labels": [
{
"id": 5,
"name": "self-hosted",
"type": "read-only"
},
{
"id": 7,
"name": "X64",
"type": "read-only"
},
{
"id": 20,
"name": "macOS",
"type": "read-only"
},
{
"id": 21,
"name": "no-gpu",
"type": "custom"
}
]
}Delete a self-hosted runner from an organization
Forces the removal of a self-hosted runner from an organization. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.
You must authenticate using an access token with the admin:org scope to use this endpoint.
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
orgstring필수The organization name. The name is not case sensitive. |
runner_idinteger필수Unique identifier of the self-hosted runner. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
204 | No Content |
코드 샘플
curl \
-X DELETE \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/orgs/ORG/actions/runners/RUNNER_IDResponse
Status: 204List self-hosted runners for a repository
Lists all self-hosted runners configured in a repository. You must authenticate using an access token with the repo scope to use this endpoint.
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
ownerstring필수The account owner of the repository. The name is not case sensitive. |
repostring필수The name of the repository. The name is not case sensitive. |
| 쿼리 매개 변수 |
| 이름, 형식, 설명 |
per_pageintegerThe number of results per page (max 100). 기본값: |
pageintegerPage number of the results to fetch. 기본값: |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
200 | OK |
코드 샘플
curl \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/repos/OWNER/REPO/actions/runnersResponse
Status: 200{
"total_count": 2,
"runners": [
{
"id": 23,
"name": "linux_runner",
"os": "linux",
"status": "online",
"busy": true,
"labels": [
{
"id": 5,
"name": "self-hosted",
"type": "read-only"
},
{
"id": 7,
"name": "X64",
"type": "read-only"
},
{
"id": 11,
"name": "Linux",
"type": "read-only"
}
]
},
{
"id": 24,
"name": "mac_runner",
"os": "macos",
"status": "offline",
"busy": false,
"labels": [
{
"id": 5,
"name": "self-hosted",
"type": "read-only"
},
{
"id": 7,
"name": "X64",
"type": "read-only"
},
{
"id": 20,
"name": "macOS",
"type": "read-only"
},
{
"id": 21,
"name": "no-gpu",
"type": "custom"
}
]
}
]
}List runner applications for a repository
Lists binaries for the runner application that you can download and run.
You must authenticate using an access token with the repo scope to use this endpoint.
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
ownerstring필수The account owner of the repository. The name is not case sensitive. |
repostring필수The name of the repository. The name is not case sensitive. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
200 | OK |
코드 샘플
curl \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/repos/OWNER/REPO/actions/runners/downloadsResponse
Status: 200[
{
"os": "osx",
"architecture": "x64",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-osx-x64-2.164.0.tar.gz",
"filename": "actions-runner-osx-x64-2.164.0.tar.gz"
},
{
"os": "linux",
"architecture": "x64",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-linux-x64-2.164.0.tar.gz",
"filename": "actions-runner-linux-x64-2.164.0.tar.gz"
},
{
"os": "linux",
"architecture": "arm",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-linux-arm-2.164.0.tar.gz",
"filename": "actions-runner-linux-arm-2.164.0.tar.gz"
},
{
"os": "win",
"architecture": "x64",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-win-x64-2.164.0.zip",
"filename": "actions-runner-win-x64-2.164.0.zip"
},
{
"os": "linux",
"architecture": "arm64",
"download_url": "https://github.com/actions/runner/releases/download/v2.164.0/actions-runner-linux-arm64-2.164.0.tar.gz",
"filename": "actions-runner-linux-arm64-2.164.0.tar.gz"
}
]Create a registration token for a repository
Returns a token that you can pass to the config script. The token expires after one hour. You must authenticate
using an access token with the repo scope to use this endpoint.
Example using registration token
Configure your self-hosted runner, replacing TOKEN with the registration token provided by this endpoint.
./config.sh --url https://github.com/octo-org/octo-repo-artifacts --token TOKEN
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
ownerstring필수The account owner of the repository. The name is not case sensitive. |
repostring필수The name of the repository. The name is not case sensitive. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
201 | Created |
코드 샘플
curl \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/repos/OWNER/REPO/actions/runners/registration-tokenResponse
Status: 201{
"token": "LLBF3JGZDX3P5PMEXLND6TS6FCWO6",
"expires_at": "2020-01-22T12:13:35.123-08:00"
}Create a remove token for a repository
Returns a token that you can pass to remove a self-hosted runner from a repository. The token expires after one hour.
You must authenticate using an access token with the repo scope to use this endpoint.
Example using remove token
To remove your self-hosted runner from a repository, replace TOKEN with the remove token provided by this endpoint.
./config.sh remove --token TOKEN
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
ownerstring필수The account owner of the repository. The name is not case sensitive. |
repostring필수The name of the repository. The name is not case sensitive. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
201 | Created |
코드 샘플
curl \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/repos/OWNER/REPO/actions/runners/remove-tokenResponse
Status: 201{
"token": "AABF3JGZDX3P5PMEXLND6TS6FCWO6",
"expires_at": "2020-01-29T12:13:35.123-08:00"
}Get a self-hosted runner for a repository
Gets a specific self-hosted runner configured in a repository.
You must authenticate using an access token with the repo scope to use this
endpoint.
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
ownerstring필수The account owner of the repository. The name is not case sensitive. |
repostring필수The name of the repository. The name is not case sensitive. |
runner_idinteger필수Unique identifier of the self-hosted runner. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
200 | OK |
코드 샘플
curl \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/repos/OWNER/REPO/actions/runners/RUNNER_IDResponse
Status: 200{
"id": 23,
"name": "MBP",
"os": "macos",
"status": "online",
"busy": true,
"labels": [
{
"id": 5,
"name": "self-hosted",
"type": "read-only"
},
{
"id": 7,
"name": "X64",
"type": "read-only"
},
{
"id": 20,
"name": "macOS",
"type": "read-only"
},
{
"id": 21,
"name": "no-gpu",
"type": "custom"
}
]
}Delete a self-hosted runner from a repository
Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.
You must authenticate using an access token with the repo
scope to use this endpoint.
매개 변수
| 헤더 |
|---|
| 이름, 형식, 설명 |
acceptstringSetting to |
| 경로 매개 변수 |
| 이름, 형식, 설명 |
ownerstring필수The account owner of the repository. The name is not case sensitive. |
repostring필수The name of the repository. The name is not case sensitive. |
runner_idinteger필수Unique identifier of the self-hosted runner. |
HTTP 응답 상태 코드
| 상태 코드 | Description |
|---|---|
204 | No Content |
코드 샘플
curl \
-X DELETE \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
https://HOSTNAME/api/v3/repos/OWNER/REPO/actions/runners/RUNNER_IDResponse
Status: 204