Создание ресурса

Метод позволяет создать новый 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"
}