bucketPutAcl method
Uploads an access control list for a bucket.
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}?acl HTTP/1.1
Path parameters
| Parameter | Description |
|---|---|
bucket |
Bucket name. |
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 permission to view the contents of a bucket and read objects within it. |
x-amz-grant-write |
Grants the access grantee object write permission. You must use this header with x-amz-grant-read, otherwise Object Storage returns the code 501 Not Implemented. |
x-amz-grant-read-acp |
Grants the access grantee bucket ACL read permission. |
x-amz-grant-write-acp |
Grants the access grantee bucket ACL write permission. |
x-amz-grant-full-control |
Grants the access grantee the following permissions: READ, WRITE, READ_ACP, and WRITE_ACP for a bucket. |
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.