HCP Tenant Management Help


Request headers (PUT bucket ACL)

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 Authentication. Yes
Content-Length

Specifies the size, in bytes, of the 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.

Conditional
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 values are application/xml and text/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 used only to add 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

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.