Метод bucketPutAcl
Загружает список управления доступом для бакета.
Примечание
ACL можно загрузить в виде XML-документа или с помощью специальных заголовков x-amx-grant*
. Не используйте XML-документ и заголовки x-amx-grant*
в одном запросе.
Запрос
PUT /{bucket}?acl HTTP/1.1
Path параметры
Параметр | Описание |
---|---|
bucket |
Имя бакета. |
Query параметры
Параметр | Описание |
---|---|
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"
Схема данных
ACL передается в виде XML-документа. Описание схемы смотрите в разделе XML-cхема ACL.
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.