Список бакетов
Метод позволяет получить список бакетов проекта
Параметры запроса
GET /api/clients/v1/s3Buckets/
Headers
- Content-Type: application/json
- Authorization: Bearer
$access_token
Query
Параметр | Тип | Ограничения | Описание | Пример |
---|---|---|---|---|
project_id | integer | > 0, обязятельный | ID проекта, с которым связан ресурс | 2 |
provider_id | integer | ID провайдера S3 | 1 | |
resource_id | integer | ID ресурса | 16 | |
status | string[] | ok / disabled / blocked | Статус CDN для бакетов | ok |
query | string | Фильтр по имени бакета | media | |
limit | integer | > 0 | Количество объектов в ответе | 50 |
offset | string | > 0 | Смещение относительно начала списка | 0 |
Параметры ответа
JSON body
Параметр | Тип | Описание |
---|---|---|
count | integer | Общее количество провайдеров |
next | string | Ссылка на предыдущую страницу |
previous | string | Ссылка на следующую страницу |
results | object[] | Список бакетов |
200 OK
Список бакетов
{
"count": 2,
"next": "http://testserver/api/clients/v1/s3Buckets?resource_id=16&status=ok&query=media",
"previous": null,
"results": [
{
"id": 42,
"name": "multimedia",
"status": "ok",
"resource_id": 16,
"last_cache_cleanup": null,
"headers": []
},
{
"id": 46,
"name": "media",
"status": "ok",
"resource_id": 16,
"last_cache_cleanup": "2024-01-01T17:17:17Z",
"headers": [
{
"key": "X-MEDIA-TYPE",
"value": ".pptx"
}
]
}
]
}
400 Bad Request
Указаны невалидные или отсутствуют обязательные query-параметры
{
"project_id": [
"This field is required."
]
}
401 Unauthorized
Учетные данные для аутентификации отсутствуют или недействительны
{
"detail": "Given token not valid for any token type",
"code": "token_not_valid",
"messages": [
{
"token_class": "AccessToken",
"token_type": "access",
"message": "Token is invalid or expired"
}
]
}
403 Forbidden
Доступны только бакеты ресурсов, связанных с проектом текущего пользователя
{
"detail": "Only participants can view this project's buckets"
}