MENU
      GetObjectACL

        GetObjectACL


        Article summary

        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.

        MethodURI
        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
        HTTP

        Request headers

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

        Request path parameters

        The following describes the parameters.

        FieldTypeRequiredDescription
        bucket-nameStringRequiredName of the bucket where the object is stored
        object-nameStringRequiredName of the object to which the ACL is applied

        Request query parameters

        The following describes the parameters.

        FieldTypeRequiredDescription
        aclStringRequiredDeclare 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
        HTTP

        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
        HTTP
        <?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>
        XML

        Was this article helpful?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.