Публичный APICI/CD21. GET /orgs/{org}/actions/runners — получить список раннеров для организации

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

Коды ответов

КодСтатусОписание
200OkСписок раннеров успешно получен
400Bad RequestНекорректные параметры запроса
403ForbiddenДоступ запрещен
404Not FoundОрганизация не найдена
500Internal Server ErrorВнутренняя ошибка сервера

Примечания:

  • убедитесь, что ключ API указан корректно и обладает необходимыми правами для доступа к организации;
  • возвращаемый список раннеров может быть ограничен параметрами page и per_page.