25. GET /repos/{owner}/{repo}/actions/runners
— получить список раннеров для репозитория
Описание
Этот метод позволяет получить список локальных раннеров, сконфигурированных для указанного репозитория. Поддерживает пагинацию. росматривать раннеры могут только те пользователи, у которых есть как минимум доступ на чтение указанного репозитория.
Параметры URL:
Параметр | Обязательный | Описание |
---|---|---|
owner | Да | Владелец репозитория (логин или имя организации) |
repo | Да | Название репозитория без расширения .git |
Параметры запроса:
Параметр | Обязательный | Описание |
---|---|---|
page | Нет | Номер страницы (начиная с 1) |
per_page | Нет | Количество результатов на странице (максимум 50) |
Тело запроса:
Данный метод не требует тела запроса.
Пример запроса:
curl -X GET "https://api.gitverse.ru/repos/myuser/myrepo/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
.