GetObjectACL

Versioning

By default, invoking the GetObjectACL operation retrieves the ACL for the current version of the object. To access the ACL of a specific version, include the versionId parameter. If the specified version is a delete marker, OSS will return a 404 Not Found error.

Request syntax

GET /ObjectName?acl HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request headers

All headers in a DescribeRegions request are common request headers. For more information, see Common request headers.

Response headers

The response to a CopyObject request contains only common response headers. For more information, see Common response headers.

Response elements

Examples

• Unversioned

  Sample Request

  GET /test-object?acl HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Wed, 29 Apr 2015 05:21:12 GMT
  Authorization: OSS qn6q**************:77Dv****************

  Sample Response

  HTTP/1.1 200 OK
  x-oss-request-id: 559CC9BDC755F95A64485981
  Date: Wed, 29 Apr 2015 05:21:12 GMT
  Content-Length: 253
  Content-Type: application/xml
  Connection: keep-alive
  Server: AliyunOSS
  
  <?xml version="1.0" ?>
  <AccessControlPolicy>
      <Owner>
          <ID>0022012****</ID>
          <DisplayName>0022012****</DisplayName>
      </Owner>
      <AccessControlList>
          <Grant>public-read </Grant>
      </AccessControlList>
  </AccessControlPolicy>

• Versioned

  Sample Request

  GET /example?acl&versionId=CAEQMhiBgMC1qpSD0BYiIGQ0ZmI5ZDEyYWVkNTQwMjBiNTliY2NjNmY3ZTVk**** HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 06:30:10 GMT
  Authorization: OSS qn6q**************:77Dv****************

  Sample Response

  HTTP/1.1 200 OK
  x-oss-version-id: CAEQMhiBgMC1qpSD0BYiIGQ0ZmI5ZDEyYWVkNTQwMjBiNTliY2NjNmY3ZTVk****
  x-oss-request-id: 5CAC3BF2B7AEADE017000621
  Date: Tue, 09 Apr 2019 06:30:10 GMT
  Content-Length: 261
  Content-Type: application/xml
  Connection: keep-alive
  Server: AliyunOSS
  
  <?xml version="1.0" encoding="UTF-8"?>
  <AccessControlPolicy>
    <Owner>
      <ID>1234513715092****</ID>
      <DisplayName>1234513715092****</DisplayName>
    </Owner>
    <AccessControlList>
      <Grant>public-read</Grant>
    </AccessControlList>
  </AccessControlPolicy>

SDKs

The GetObjectACL operation can be called using OSS SDKs for the following programming languages:

• Java

• Python

• Go V2

• PHP

• Node.js

• Browser.js

• .NET

• C++

• C

Command line tool ossutil

For the ossutil command corresponding to the GetObjectACL operation, refer to get-object-acl.

Error codes