PUT object with ACL request headers

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

Request header Description Required
Authorization See AWS authentication. 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 an object. 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 object.

This header is required for adding a canned ACL to an object. 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 object to one or more specified grantees.

If you’re using an ACL request body or a canned ACL to add an ACL to an object, 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 object to one or more specified grantees.

If you’re using an ACL request body or a canned ACL to add an ACL to an object, the x-amz-grant-read header is invalid.

No
x-amz-grant-read-acp

Grants the read ACL data access permission for the object to one or more specified grantees.

If you’re using an ACL request body or a canned ACL to add an ACL to an object, the x-amz-grant-read-acp header is invalid.

No
x-amz-grant-write

Grants the write and delete data access permissions for the object to one or more specified grantees.

If you’re using an ACL request body or a canned ACL to add an ACL to an object, the x-amz-grant-write header is invalid.

No
x-amz-grant-write-acp

Grants the write ACL data access permission for the object to one or more specified grantees.

If you’re using an ACL request body or a canned ACL to add an ACL to an object, the x-amz-grant-write-acp header is invalid.

No

Trademarks and Legal Disclaimer

© 2017 Hitachi Data Systems Corporation. All rights reserved.