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. Don't 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 |
Bucket name. |
key |
Object key. ID 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.
Header | 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 an 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 — 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 the schema description, see ACL XML schema.
Response
Headers
Responses can only contain common response headers.
Response codes
For a list of possible responses, see Responses.