Help Center> Object Storage Service> SDK Reference> Python> Objects-Related APIs> Obtaining Object ACL Information
View PDF

Obtaining Object ACL Information

API Description

You can use this API to obtain the ACL information of an object in a specified bucket.

Method Definition

ObsClient.getObjectAcl(bucketName, objectKey, versionId)

Request Parameters

Field

Type

Optional or Mandatory

Description

bucketName

str

Mandatory

Bucket name

objectKey

str

Mandatory

Object name

versionId

str

Optional

Object version ID

Returned Results

Type

Description

GetResult

SDK common result object

GetResult.body Type

Description

ACL

Object ACL

Sample Code

try:
    resp = obsClient.getObjectAcl('bucketname', 'objectkey') 
        
    if resp.status < 300: 
        print('requestId:', resp.requestId) 
        print('owner_id:', resp.body.owner.owner_id) 
        print('owner_name:', resp.body.owner.owner_name) 
         
        index = 1 
        for grant in resp.body.grants: 
            print('grant [' + str(index) + ']') 
            print('grantee_id:', grant.grantee.grantee_id) 
            print('grantee_name:', grant.grantee.grantee_name) 
            print('group:', grant.grantee.group) 
            print('permission:', grant.permission) 
            index += 1 
    else: 
        print('errorCode:', resp.errorCode) 
        print('errorMessage:', resp.errorMessage)
except:
    import traceback
    print(traceback.format_exc())
Parent topic: Objects-Related APIs