Oracle^® ZFS Storage Appliance Object API Guide for Amazon S3 Service Support, Release OS8.8.0

GET Object ACL

The GET Object ACL operation returns the Access Control List (ACL) for the specified object. To use this operation, you must have READ_ACP access to the object. For more details about this operation, see the following:

• Syntax Example

• Request Parameters

• Request Headers

• Request Elements

• Response Headers

• Response Elements

• Normal Response Code

• Error Response Code

Syntax Example

GET https://<appliance>:443/s3/v1/export/<share_mount_point_path>/<bucketname>/<objectname>?acl

Request Parameters

This implementation of the GET Object ACL does not support the use of request parameters.

Request Headers

The GET Object ACL operation uses only request headers that are common to all operations. For more information, see Figure 7, Table 7, Common Supported Request Headers .

Request Elements

The GET Object ACL operation does not support the use of request elements.

Response Headers

The GET Object ACL operation uses only response headers that are common to most responses. For more information, see Figure 9, Table 9, Supported Response Headers .

Response Elements

For a list of supported elements in the XML response for the GET Object ACL operation, see Amazon's official S3 GET Object ACL API documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGETacl.html).

Normal Response Code

200 OK

Error Response Code

The GET Object API does not return special errors. For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.

Example

Sample Response

GET /my-image.jpg?acl
HTTP/1.1 200 OK
x-amz-request-id: tx318BC8BC148832E5
x-amz-version-id: 009
Date: Wed, 28 Oct 2018 22:32:00 GMT
Last-Modified: Sun, 1 Jan 2018 12:00:00 GMT
Content-Length: 124
Content-Type: text/plain
Connection: close

<AccessControlPolicy>
  <Owner>
    <ID>micky</ID>
    <DisplayName>micky</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee type="CanonicalUser">
        <ID>minny</ID>
        <DisplayName>minny</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>

Sample Request Getting the ACL of the Specific Version of an Object

GET /my-image.jpg?versionId=0003
HTTP/1.1 200 OK
x-amz-request-id: 318BC8BC148832E5
Date: Wed, 28 Oct 2018 22:32:00 GMT
Last-Modified: Sun, 1 Jan 2018 12:00:00 GMT
x-amz-version-id: 0004
Content-Length: 124
Content-Type: text/plain
Connection: close

<AccessControlPolicy>
  <Owner>
    <ID>micky</ID>
    <DisplayName>micky</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xsi:type="CanonicalUser">
        <ID>minny</ID>
        <DisplayName>minny</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>