Метод create
Статья создана
Обновлена 6 сентября 2024 г.
Создает бакет.
Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.
Запрос
PUT /{bucket} HTTP/2
Path параметры
Параметр | Описание |
---|---|
bucket |
Имя бакета. При создании бакета помните об ограничениях на имя. |
Заголовки
Используйте в запросе общие заголовки.
С помощью заголовков, перечисленных ниже, можно установить ACL создаваемого бакета.
Заголовок | Описание |
---|---|
X-Amz-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"
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.
Успешный ответ не содержит дополнительных данных.