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 |
© 2017 Hitachi Data Systems Corporation. All rights reserved.