Создание бакета

Метод необходим для создания бакетов в рамках указанного S3 ресурса

info

При добавлении бакета CDN для него активируется автоматически

info

Дополнительные заголовки, указанные при создании будут добавлены ко всем ответам сервера при обращении к соответствующему бакету

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

POST /api/clients/v1/s3Buckets/

Headers

• Content-Type: application/json
• Authorization: Bearer $access_token

JSON body

Параметр	Тип	Ограничения	Описание	Пример
name	string	обязательный	Название бакета	assets
resource_id	integer	> 0, обязательный	ID ресурса	2
headers	object[]		Список дополнительных HTTP-заголовков
headers.key	string		Название заголовка	X-MEDIA-TYPE
headers.value	string		Значение заголовка	.pptx

note

Название бакета должно соответствовать правилам, предусмотренным провайдером S3 и быть уникальным в рамках одного ресурса

Параметры ответа

JSON body

Параметр	Тип	Описание
id	integer	ID бакета
name	string	Название бакета
status	string	Статус CDN для бакета
resource_id	integer	ID ресурса
last_cache_cleanup	string	Время последней очистки кеша для бакета
headers	object[]	Список дополнительных HTTP-заголовков
headers.key	string	Название заголовка
headers.value	string	Значение заголовка

201 Created

Объект бакета

{
  "id": 46,
  "name": "media",
  "status": "ok",
  "resource_id": 16,
  "last_cache_cleanup": null,
  "headers": [
    {
      "key": "X-MEDIA-TYPE",
      "value": ".pptx"
    }
  ]
}

400 Bad Request

Указаны невалидные или отсутствуют обязательные body-параметры

{
  "name": [
    "Bucket name is not a valid string"
  ],
  "resource_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 project participants can create buckets for this project"
}

409 Conflict

Ресурс с такими параметрами уже существует

{
  "detail": "Bucket with this name already exists"
}