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