Создание бакета
Метод необходим для создания бакетов в рамках указанного 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"
}