Метод create

Создает бакет.

Запрос

PUT /{bucket} HTTP/1.1

Path параметры

Параметр Описание
bucket Имя бакета.

При создании бакета помните об ограничениях на имя.

Заголовки

Используйте в запросе общие заголовки.

С помощью заголовков, перечисленных ниже, можно установить ACL создаваемого бакета.

Заголовок Описание
x-amz-acl Устанавливает предопределенный ACL для объекта.
x-amz-grant-read Устанавливает получателю доступа разрешение на просмотр содержимого бакета и разрешение на чтение объектов в бакете.
x-amz-grant-write Устанавливает получателю доступа разрешение на запись объектов. Используйте обязательно вместе с x-amz-grant-read, иначе Object Storage ответит с кодом 501 Not Implemented.
x-amz-grant-read-acp Устанавливает получателю доступа разрешение на чтение ACL бакета.
x-amz-grant-write-acp Устанавливает получателю доступа разрешение на запись ACL бакета.
x-amz-grant-full-control Устанавливает получателю доступа разрешения: READ, WRITE, READ_ACP, WRITE_ACP на бакет.

Значение для заголовков x-amz-grant-* представляет собой разделенный запятыми список получателей доступа. Каждый получатель доступа идентифицируется структурой вида <тип получателя доступа>:<идентификатор получателя доступа>. Object Storage поддерживает следующие типы получателей:

  • id — получатель доступа — пользователь облака.
  • uri — получатель доступа — системная группа.

Пример:

x-amz-grant-read: uri="http://acs.amazonaws.com/groups/s3/AuthenticatedUsers"

Ответ

Заголовки

Ответ может содержать только общие заголовки.

Коды ответов

Перечень возможных ответов смотрите в разделе Ответы.

Успешный ответ не содержит дополнительных данных.