GetObjectAcl

Returns the access control list (ACL) of an object in a QStorage bucket.

Permissions Required

To perform this operation, you need one of the following permissions:

• READ_ACP permission on the object
• Bucket owner
• Object owner

Request

Request Headers

Name	Description	Required	Type
x-amz-request-payer	Confirms that the requester knows that they will be charged for the request.	No	String

URI Parameters

Name	Description	Required	Type
versionId	Version ID of the object whose ACL you want to retrieve.	No	String

Request Body

This operation does not have a request body.

Request Syntax

GET /{object-key}?acl HTTP/1.1
Host: {bucket-name}.qstorage.quilibrium.com
x-amz-request-payer: requester

Response

Response Headers

Name	Description	Required	Type
x-amz-request-charged	If present, indicates that the requester was successfully charged for the request.	No	String

Response Elements

Name	Description	Required	Type
AccessControlList	Container for the ACL information.	No	Container
Grant	Container for the grantee and permissions.	No	Container
Grantee	The person being granted permissions.	No	Container
ID	The ID of the grantee.	No	String
DisplayName	Screen name of the grantee.	No	String
Permission	Specifies the permission given to the grantee.	No	String
Owner	Container for the bucket owner's information.	No	Container

Error Responses

Name	Description	Required	Type
NoSuchKey	The specified key does not exist.	No	String
NoSuchBucket	The specified bucket does not exist.	No	String

Examples

Example Request

GET /example-object?acl HTTP/1.1
Host: example-bucket.qstorage.quilibrium.com

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<AccessControlPolicy>
   <Owner>
      <ID>*** Owner-ID ***</ID>
      <DisplayName>owner-display-name</DisplayName>
   </Owner>
   <AccessControlList>
      <Grant>
         <Grantee>
            <ID>*** Owner-ID ***</ID>
            <DisplayName>owner-display-name</DisplayName>
         </Grantee>
         <Permission>FULL_CONTROL</Permission>
      </Grant>
   </AccessControlList>
</AccessControlPolicy>

API Tester

Test

Coming Soon

This feature is currently under development and will be available soon.