get-object-acl用于获取存储空间(Bucket)下某个文件(Object)的访问权限(ACL)。
注意事项
阿里云账号默认拥有获取文件ACL的权限。如果您需要通过RAM用户或者STS的方式获取,您必须拥有
oss:GetObjectAcl
权限。具体操作,请参见为RAM用户授权自定义的权限策略。如果一个Object从未设置过ACL,则调用GetObjectACL时,返回的ObjectACL为default,表示该Object的ACL遵循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对应的版本。 |
说明
get-object-acl命令对应API接口GetObjectACL。关于API中的具体参数含义,请参见GetObjectACL。
关于支持的全局命令行选项,请参见支持的全局命令行选项。
使用示例
获取存储空间
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
文档内容是否对您有帮助?