Список бакетов

Метод позволяет получить список бакетов проекта

Параметры запроса

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"
}