objectPutAcl method

Uploads an access control list for an object.

Note

ACLs can be uploaded as XML documents or using special x-amx-grant* headers. Do not use XML documents and x-amx-grant* headers in the same request.

Request

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

Path parameters

Parameter Description
bucket Name of the bucket.
key Object key. ID to use for saving the object in Object Storage.

Query parameters

Parameter Description
acl Required parameter that indicates the type of operation.

Headers

Use the necessary common request headers in requests.

You can also use the headers listed below.

Heading Description
x-amz-acl Sets a predefined ACL for an object.
x-amz-grant-read Grants the access grantee object read permission.
x-amz-grant-read-acp Grants the access grantee object ACL read permission.
x-amz-grant-write-acp Grants the access grantee object ACL write permission.
x-amz-grant-full-control Grants the access grantee the following permissions: READ, WRITE, READ_ACP, and WRITE_ACP for an object.

The value for a x-amz-grant-* header is a comma-separated list of access grantees. Each access grantee is identified in a structure like: <access grantee type>:<access grantee ID>. Object Storage supports the following types of access grantees:

  • id — access grantee — Yandex.Cloud user.
  • uri — access grantee — system group.

Example:

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

Data schema

ACLs are passed as XML documents. For a description of the schema, see ACL XML schema.

Response

Headers

Responses can only contain common response headers.

Response codes

For a list of possible responses, see Responses.