全部文档
当前文档
最近更新时间：2025-11-07 14:53:08
set-acl命令用于设置Object的读写权限ACL。
以下示例均以Linux为例。
./ks3util set-acl ks3://bucketname[/prefix] <acl>
[-r, --recursive]
[-f, --force]
[-b, --bucket]
[--include <value>]
[--exclude <value>]
[--time-range <value>]
[-j, --jobs <value>]参数 | 说明 |
|---|---|
bucketname | 操作的桶名。 |
prefix | 操作的对象的前缀。 |
acl | 读写权限ACL，可选值：private，public-read。 |
-r, --recursive | 递归进行操作。当指定该选项时，会对存储空间下所有符合条件的对象进行操作，否则只对路径指定的定的单个对象进行操作。 |
-f, --force | 强制操作，不进行询问提示。 |
-b, --bucket | 对Bucket进行操作，该选项用于确认操作作用于Bucket。 |
--include | 包含对象匹配模式，满足匹配规则的文件将会被选中，如：*.jpg。 该选项可以出现多次，多个--include规则取并集。 |
--exclude | 不包含对象匹配模式，满足匹配规则的文件将会被排除，如：*.txt。 该选项可以出现多次，多个--exclude规则取并集。 |
--time-range | 时间段匹配模式，仅匹配最后修改时间在该时间段内的文件。时间段格式为：time1-time2，其中time1、time2需要填写UTC时间，格式为：yyyyMMddHHmmss。 详细请参考通用选项&过滤规则文档。 |
-j, --jobs | 多文件操作时的并发任务数，默认值：5，取值范围：1-10000。 Util2.9.0版本默认值由3改为5。 |
除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。
示例一：给单个文件设置acl。
./ks3util set-acl ks3://samplebucket/src-prefix/sample.txt private示例二：批量设置acl。
批量给指定前缀的文件设置acl。
./ks3util set-acl ks3://samplebucket/src-prefix/ private -r批量给符合匹配规则的文件设置acl。
./ks3util set-acl ks3://samplebucket/src-prefix/ private -r --include *screenshot* --exclude *important*批量给指定列表文件设置acl。
./ks3util set-acl ks3://samplebucket/ public-read --object-file object_keys_fileobject_keys_file为本地.txt文件的路径，文件内填写指定Object列表，每个objectKey为一行（不包含ks3://bucket/ 部分）。
示例三：批量给最后修改时间在指定范围的文件设置acl。
./ks3util set-acl ks3://samplebucket/src-prefix/ private -r --time-range "20241106120000-20241110120000"纯净模式