Метод objectPutAcl

Загружает список управления доступом для объекта.

Примечание

ACL можно загрузить в виде XML-документа или с помощью специальных заголовков x-amx-grant*. Не используйте XML-документ и заголовки x-amx-grant* в одном запросе.

Запрос

PUT /{bucket}/{key}?acl HTTP/1.1

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-cхема ACL.

Ответ

Заголовки

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

Коды ответов

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