put-object-acl

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对应的版本

说明

使用示例

设置目标存储空间examplebucket的访问权限为private。

ossutil api put-object-acl --bucket examplebucket --key exampleobject --object-acl private