All Documents
Current Document

Content is empty

If you don't find the content you expect, please try another search term

Documentation

GET Object ACL

Last updated:2021-09-14 16:18:12

Description

This GET operation uses the acl sub resource to return the ACL(access control list)' of the object'.
Only the bucket owner has permission to call the interface.

Request

Syntax

GET /{ObjectKey}?acl HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

Attention:

Request Parameters

The interface does not use request parameters.

Request Headers

This interface can use all common request headers. For more information, please click Public Request Headers.

Request Elements

The interface does not use the requested elements.

Response

Response Headers

This interface can use all common response headers. For more information, please click Public Response Headers.

Response Elements

Name Description
AccessControlList Container containing Grant,Grantee,Permission
Type:Container
Ancestors:AccessControlPolicy
AccessControlPolicy Contains the ACL permission setting information of each Grantee for an object
Type:Container
Ancestors:None
Grant Contains information about authorized persons and their permissions.
Type:String
Ancestors:AccessControlPolicy.AccessControlList
Grantee Authorized person
Type:String
Ancestors:AccessControlPolicy.AccessControlList.Grant
DisplayName Bucket owner's name
Type:String
Ancestors:AccessControlPolicy.Owner
ID The user ID of the bucket owner or the ID of the authorized person
Type:String
Ancestors:AccessControlPolicy.Owner or AccessControlPolicy.AccessControlList.Grant
Owner Container containing bucket owner information (DisplayName,ID)
Type:Container
Ancestors:AccessControlPolicy
Permission Indicates the permission information granted to the authorized person(FULL_CONTROL,READ,WRITE
Type:String
Ancestors:AccessControlPolicy.AccessControlList.Grant

Special Errors

The interface does not return any special errors.

Examples

The following request will return the ACL information of the corresponding object, my-image.jpg.

Sample Request

GET /my-image.jpg?acl HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Fri, 26 Dec 2014 07:14:18 GMT
Authorization: authorization string

Sample Response

HTTP/1.1 200 OK
Date: Fri, 26 Dec 2014 07:14:18 GMT
Last-Modified: Sun, 1 Jan 2009 12:00:00 GMT
Content-Length: 124
Content-Type: text/plain
Connection: close
Server: Tengine

<AccessControlPolicy>
<Owner>
<ID>73410125</ID>
<DisplayName>ks3@kingsoft.com</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>73404060</ID>
<DisplayName>ks3_dt@kingsoft.com</DisplayName>
</Grantee>
<Permission>FULL_CONTROL</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>
On this page
Pure ModeNormal Mode

Pure Mode

Click to preview the document content in full screen
Feedback