PUT bucket ACL request headers

The table below describes the headers you can use in a request to add an ACL to a bucket.

Request header Description Required
Authorization See AWS authentication. You cannot create a bucket as an anonymous user. Yes
Content-Length Specifies the size, in bytes, of the ACL request body. This header is required when you’re using an ACL request body to add an ACL to the bucket. If you’re using ACL headers to add the ACL, the Content-Length header is invalid. No
Content-Type Specifies the Internet media type of the request body. This header is valid only when the ACL is specified in the request body. The only valid value is application/xml. No
Date See Common request headers. Date or x-amz-date
Host See Common request headers. Yes
x-amz-acl Adds a canned ACL to the bucket. This header is required for adding a canned ACL to a bucket. If you’re using an ACL request body or individual x-amz-grant- headers to add the ACL, the x-amz-acl header is invalid. For valid values for this header, see Canned ACLs. No
x-amz-date See Common request headers. x-amz-date or Date
x-amz-grant-full-control Grants full control over the bucket to one or more specified grantees. If you’re using an ACL request body or a canned ACL to add an ACL to the bucket, the x-amz-grant-full-control header is invalid. For valid values for this and the following x-amz-grant- headers, see Specifying an ACL with headers. No
x-amz-grant-read Grants the browse and read data access permissions for the bucket to one or more specified grantees. If you’re using an ACL request body or a canned ACL to add an ACL to the bucket, the x-amz-grant-read header is invalid. No
x-amz-grant-read-acp Grants the read ACL data access permission for the bucket to one or more specified grantees. If you’re using an ACL request body or a canned ACL to add an ACL to the bucket, the x-amz-grant-read-acp header is invalid. No
x-amz-grant-write Grants the write and delete data access permissions for the bucket to one or more specified grantees. If you’re using an ACL request body or a canned ACL to add an ACL to the bucket, the x-amz-grant-write header is invalid. No
x-amz-grant-write-acp Grants the write ACL data access permission for the bucket to one or more specified grantees. If you’re using an ACL request body or a canned ACL to add an ACL to the bucket, the x-amz-grant-write-acp header is invalid. No

Trademarks and Legal Disclaimer

© 2016 Hitachi Data Systems Corporation. All rights reserved.