Метод objectPutAcl
Загружает список управления доступом для объекта.
Примечание
ACL можно загрузить в виде XML-документа или с помощью специальных заголовков X-Amz-Grant*
. Не используйте XML-документ и заголовки X-Amz-Grant*
в одном запросе.
Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.
Запрос
PUT /{bucket}/{key}?acl HTTP/2
Path параметры
Параметр | Описание |
---|---|
bucket |
Имя бакета. |
key |
Ключ объекта. Идентификатор, под которым объект будет сохранен в Object Storage. |
Query параметры
Параметр | Описание |
---|---|
acl |
Обязательный параметр для обозначения типа операции. |
Заголовки
Используйте в запросе необходимые общие заголовки.
Также можно использовать заголовки, перечисленные ниже.
Заголовок | Описание |
---|---|
X-Amz-Acl |
Устанавливает предопределенный ACL для объекта. |
X-Amz-Grant-Read |
Устанавливает получателю доступа разрешение на чтение объекта. |
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-схема ACL.
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.