PUT bucket request headers

The table below describes the headers you can use in a request to create 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 request body. For a request to create a bucket, the value of this header must be 0 (zero). Yes
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 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 a canned ACL to add an ACL to a 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 a canned ACL to add an ACL to a 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 a canned ACL to add an ACL to a 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 a canned ACL to add an ACL to a 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 a canned ACL to add an ACL to a bucket, the x-amz-grant-write-acp header is invalid.

No

Trademark and LegalDisclaimer

© 2015 Hitachi Data Systems Corporation. All rights reserved.