金山云-文档中心-对象标签（set-tag）

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

常用工具

工具汇总

KS3Util命令行工具

对象操作

对象标签（set-tag）

最近更新时间：2025-11-07 14:48:18



该命令可设置、更新、删除指定Objects的tagging信息。

tagging的key和value区分大小写。

命令格式

./ks3util set-tag ks3://bucketname[/prefix] <tagging>
[-r, --recursive] 
[-f, --force] 
[-u, --update]
[--delete] 
[--include <value>]
[--exclude <value>]
[--time-range <value>]
[-j, --jobs <value>]

参数说明

参数	说明
bucketname	操作的桶名。
prefix	操作的对象的名称或前缀。
-r, --recursive	递归进行操作。当指定该选项时，会对存储空间下所有符合条件的对象进行操作，否则只对路径指定的定的单个对象进行操作。
-f, --force	强制操作，不进行询问提示。
-u, --update	更新操作。
--delete	删除所有tagging。
--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支持的通用选项参数，详情请参考通用选项&过滤规则文档。

使用示例

示例一：设置标签。
如果用户未指定--update选项和--delete选项，KS3Util会设置指定Objects的tagging为用户输入的"tag=value&tag=value"。
- 设置单个文件的标签。
```
./ks3util set-tag ks3://samplebucket/test-files/sample.txt "belongs=kevin&test-file=true"
```
- 设置指定前缀的所有文件的标签。
```
./ks3util set-tag ks3://samplebucket/test-files/ "belongs=kevin&test-file=true" -r
```
- 设置匹配条件的文件的标签。
```
./ks3util set-tag ks3://samplebucket/test-files/ "belongs=kevin&test-file=true" -r --include *.log --exclude tom-*
```
- 设置最后修改时间在指定范围的文件的标签。
```
./ks3util set-tag ks3://samplebucket/test-files/ "belongs=kevin&test-file=true" -r --time-range "20241106120000-20241110120000"
```
- 设置指定列表文件的标签。
```
./ks3util set-tag ks3://samplebucket/ "belongs=kevin&test-file=true" --object-file object_keys_file
```
  object_keys_file为本地.txt文件的路径，文件内填写指定Object列表，每个objectKey为一行（不包含ks3://bucket/ 部分）。
示例二：更新标签。
如果用户设置--update选项，KS3Util会更新指定Objects的指定tagging为输入的value值，value值不可以为空，指定Objects的其他tagging信息不会改变。此时不支持--delete选项。
- 更新单个文件的标签。
```
./ks3util set-tag ks3://samplebucket/test-files/sample.txt "belongs=kevin&test-file=true" --update
```
- 更新指定前缀的所有文件的标签。
```
./ks3util set-tag ks3://samplebucket/test-files/ "belongs=kevin&test-file=true" -r --update 
```
- 更新匹配条件的文件的标签。
```
./ks3util set-tag ks3://samplebucket/test-files/ "belongs=kevin&test-file=true" -r --include *.log --exclude tom-* --update
```
- 更新最后修改时间在指定范围的文件的标签。
```
./ks3util set-tag ks3://samplebucket/test-files/ "belongs=kevin&test-file=true" -r --update --time-range "20241106120000-20241110120000"
```
- 更新指定列表文件的标签。
```
./ks3util set-tag ks3://samplebucket/ "belongs=kevin&test-file=true" --object-file object_keys_file --update
```
  object_keys_file为本地.txt文件的路径，文件内填写指定Object列表，每个objectKey为一行（不包含ks3://bucket/ 部分）。
示例三：删除标签。
如果用户设置--delete选项，KS3Util会删除所有标签。此时不支持--update选项。
- 删除单个文件的标签。
```
./ks3util set-tag ks3://samplebucket/test-files/sample.txt  --delete
```
- 删除指定前缀的所有文件的标签。
```
./ks3util set-tag ks3://samplebucket/test-files/ -r --delete
```
- 删除匹配条件的文件的标签。
```
./ks3util set-tag ks3://samplebucket/test-files/  -r --include *.log --exclude tom-* --delete
```
- 删除最后修改时间在指定范围的文件的标签。
```
./ks3util set-tag ks3://samplebucket/test-files/ -r --delete --time-range "20241106120000-20241110120000"
```
- 删除指定列表文件的标签。
```
./ks3util set-tag ks3://samplebucket/  --object-file object_keys_file --delete
```
  object_keys_file为本地.txt文件的路径，文件内填写指定Object列表，每个objectKey为一行（不包含ks3://bucket/ 部分）。

文档导读

上一篇：查看文件信息（stat）

下一篇：标准输出流（cat）

纯净模式常规模式

纯净模式

点击可全屏预览文档内容