Создание ресурса
Метод позволяет создать новый S3 ресурс. Ресурс будет ассоциирован с указанным проектом и предоставленным провайдером
к сведению
При успешном запросе будет создана задача, прогресс выполнения которой можно отслеживать, используя API задач
Параметры запроса
POST /api/clients/v1/s3Resources/
Headers
- Content-Type: application/json
- Authorization: Bearer
$access_token
JSON body
Параметр | Тип | Ограничения | Описание | Пример |
---|---|---|---|---|
project_id | integer | > 0, обязательный | ID проекта, с которым связан ресурс | 2 |
name | string | 0 < length < 256, обязательный | Название ресурса | storage-europe |
provider_id | integer | > 0, обязательный | ID провайдера S3 | 2 |
provider_proto | string | http | https, обязательный | URL схема провайдера S3 | https |
provider_host | string | 0 < length < 256, обязательный | Hostname провайдера S3 | storage.googleapis.com |
provider_port | integer | > 0, < 65536, обязательный | Номер порта провайдера S3 | 443 |
примечание
Название ресурса должно быть уникальным в рамках одного проекта
Параметры ответа
JSON body
Параметр | Тип | Описание |
---|---|---|
task_id | string | ID задачи |
Примеры
200 OK
ID задачи на создание ресурса. Результат выполнения задачи и ID созданного ресурса содержатся в объекте задачи
{
"task_id": "bb4dcd80-01a5-4a73-8c2b-62c5027a9b72"
}
400 Bad Request
Указаны невалидные или отсутствуют обязательные body-параметры
{
"provider_host": [
"This field may not be blank."
],
"provider_port": [
"Ensure this value is less than or equal to 65535."
]
}
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 view this project's resources"
}
409 Conflict
Ресурс с такими параметрами уже существует
{
"detail": "Resource with this parameters already exists"
}