put-object-acl用于设置或修改文件(Object)的访问权限(ACL)。
注意事项
阿里云账号默认拥有设置文件ACL的权限。如果您需要通过RAM用户或者STS的方式进行设置,您必须拥有
oss:PutObjectAcl
权限。具体操作,请参见为RAM用户授权自定义的权限策略。此操作只有Bucket的拥有者有权限执行,且需对Object有读写权限。Object ACL优先级高于Bucket ACL。例如Bucket ACL是private的,而Object ACL是public-read-write的,则所有用户都拥有该Object的访问权限,即使该Bucket是私有Bucket。如果某个Object未设置过ACL,则访问权限遵循Bucket ACL。
命令格式
ossutil api put-object-acl --bucket value --key value --object-acl value [flags]
参数 | 类型 | 说明 |
--bucket | string | Bucket名称。 |
--key | string | Object的完整路径。 |
--object-acl | string | 指定OSS创建Object时的访问权限 |
--version-id | string | Object对应的版本 |
说明
put-object-acl命令对应API接口PutObjectACL。关于API中的具体参数含义,请参见PutObjectACL。
关于支持的全局命令行选项,请参见支持的全局命令行选项。
使用示例
设置目标存储空间examplebucket
的访问权限为private。
ossutil api put-object-acl --bucket examplebucket --key exampleobject --object-acl private
文档内容是否对您有帮助?