获取对象 ACL

功能说明

获取指定文件的 ACL 信息。

方法原型

  1. func (s *ObjectService) GetACL(ctx context.Context, key string) (*ObjectGetACLResult, *Response, error)

请求示例

  1. key := "test/hello.txt"
  2. v, resp, err := client.Object.GetACL(context.Background(), key)

参数说明

参数名称参数描述类型必填
key对象键(Key)是对象在存储桶中的唯一标识。例如,在对象的访问域名 bucket1-1250000000.cos.ap-guangzhou.myqcloud.com/doc1/pic1.jpg 中,对象键为 doc1/pic1.jpgstring

返回结果说明

  1. type ACLXml struct {
  2. Owner *Owner
  3. AccessControlList []ACLGrant
  4. }
  5. type Owner struct {
  6. ID string
  7. DisplayName string
  8. }
  9. type ACLGrant struct {
  10. Grantee *ACLGrantee
  11. Permission string
  12. }
  13. type ACLGrantee struct {
  14. Type string
  15. ID string
  16. DisplayName string
  17. UIN string
  18. }
参数名称参数描述类型
OwnerBucket 拥有者的信息,包括 DisplayName 和 IDstruct
AccessControlListBucket 权限授予者的信息,包括 Grantee和 Permissionstruct
Grantee权限授予者的信息,包括 DisplayName,Type,ID 和 UINstruct
Type权限授予者的类型,类型为 CanonicalUser 或者 Groupstring
IDType 为 CanonicalUser 时,对应权限授予者的 IDstring
DisplayName权限授予者的名字string
UINType 为 Group 时,对应权限授予者的 UINstring
Permission授予者所拥有的 Bucket 的权限,可选值有 FULL_CONTROL,WRITE,READ,分别对应读写权限、写权限、读权限string