23. GET /orgs/{org}/actions/runners/{runner_id}
— получить информацию о раннере для организации
Описание
Этот метод позволяет получить подробную информацию о локальном раннере, сконфигурированном для организации по его ID. Детали раннера могут просматривать только те пользователи, у которых есть как минимум доступ на чтение указанной организации.
Параметры URL:
Параметр | Обязательный | Описание |
---|---|---|
org | Да | Имя организации |
runner_id | Да | Уникальный идентификатор раннера |
Тело запроса:
Данный метод не требует тела запроса.
Пример запроса:
curl -X GET "https://api.gitverse.ru/orgs/myorg/actions/runners/123" \
-H "Authorization: Bearer YOUR_TOKEN"
Ответ (200 OK
):
Ответ содержит информацию о раннере.
{
"id": 123,
"name": "runner-01",
"status": "online",
"busy": false,
"labels": [
{
"id": 1,
"name": "linux",
"type": "agent"
}
]
}
Формат ответа: application/vnd.gitverse.object+json;version=1
Коды ответов
Код | Статус | Описание |
---|---|---|
200 | Ok | Информация о раннере успешно получена |
400 | Bad Request | Некорректные параметры запроса |
403 | Forbidden | Доступ запрещен |
404 | Not Found | Организация или раннер не найдены |
500 | Internal Server Error | Внутренняя ошибка сервера |
Примечания:
- убедитесь, что ключ API указан корректно и обладает необходимыми правами для доступа к организации;
- раннер должен существовать в рамках указанной организации.