get-object-acl

get-object-acl用于获取存储空间(Bucket)下某个文件(Object)的访问权限(ACL)。

注意事项

  • 阿里云账号默认拥有获取文件ACL的权限。如果您需要通过RAM用户或者STS的方式获取,您必须拥有oss:GetObjectAcl权限。具体操作,请参见RAM用户授权自定义的权限策略

  • 如果一个Object从未设置过ACL,则调用GetObjectACL时,返回的ObjectACLdefault,表示该ObjectACL遵循Bucket ACL。即如果Bucket的访问权限是private,则该Object的访问权限也是private。

命令格式

ossutil api get-object-acl --bucket value --key value [flags]

参数

类型

说明

--bucket

string

Bucket名称。

--key

string

Object的完整路径。

--version-id

string

Object对应的版本。

说明

使用示例

  • 获取存储空间examplebucket的访问权限。

    ossutil api get-object-acl --bucket examplebucket --key exampleobject
  • 获取存储空间examplebucket的访问权限,以JSON格式显示。

    ossutil api get-object-acl --bucket examplebucket --key exampleobject --output-format json
  • 获取存储空间examplebucket的访问权限,以YAML格式显示。

    ossutil api get-object-acl --bucket examplebucket --key exampleobject --output-format yaml