GetObjectACL

English

GetObjectACL

Article summary

Did you find this summary helpful?

Thank you for your feedback

Available in Classic and VPC

View the ACLs applied to an object.

Note

For a description of the types of permissions and default ACLs that can be granted by the Object Storage service, see Object Storage overview.

Requests

The following describes the request format for the endpoint. The request format is as follows.

Method	URI
GET	/{bucket-name}/{object-name}

Request syntax

The request syntax is as follows.

GET https://{endpoint}/{bucket-name}/{object-name}?acl= # path style
GET https://{bucket-name}.{endpoint}/{object-name}?acl= # virtual host style

Request headers

For headers common to all Object Storage APIs, see Object Storage common headers.

Request path parameters

The following describes the parameters.

Field	Type	Required	Description
`bucket-name`	String	Required	Name of the bucket where the object is stored
`object-name`	String	Required	Name of the object to which the ACL is applied

Request query parameters

The following describes the parameters.

Field	Type	Required	Description
`acl`	String	Required	Declare to apply the default ACL to the object Enter only keys without values

Request example

The following is a sample request.

GET /example-bucket/queen-bee?acl= HTTP/1.1
Authorization: {authorization-string}
x-amz-date: 20161207T155945Z
Host: kr.object.ncloudstorage.com

Responses

The following describes the response format.

Response headers

For response headers common to all Object Storage APIs, see Object Storage common response headers.

Response status codes

For response status codes common to all Object Storage APIs, see Object Storage response status codes.

Response example

The following is a sample response.

HTTP/1.1 200 OK
Date: Wed, 07 Dec 2016 15:59:46 GMT
Accept-Ranges: bytes
x-amz-request-id: 78541562-29bf-4800-9eb3-0c360f0a037a
Content-Type: application/xml
Content-Length: 550

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Owner>
        <ID>{owner-user-id}</ID>
        <DisplayName>{owner-user-id}</DisplayName>
    </Owner>
    <AccessControlList>
        <Grant>
            <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
                <URI>http://acs.amazonaws.com/groups/global/AuthenticatedUsers</URI>
            </Grantee>
            <Permission>READ</Permission>
        </Grant>
        <Grant>
            <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
                <ID>{owner-user-id}</ID>
                <DisplayName>{owner-user-id}</DisplayName>
            </Grantee>
            <Permission>FULL_CONTROL</Permission>
        </Grant>
    </AccessControlList>
</AccessControlPolicy>

Was this article helpful?

What's Next

OptionsObjectCORS

Table of contents

Requests
Responses