设置对象标签

功能介绍

设置对象标签。

接口约束

您必须是对象拥有者或拥有设置对象标签的权限，才能设置对象标签。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:PutObjectTagging权限，如果使用桶策略则需授予PutObjectTagging权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。

命令结构

Windows操作系统

设置单个对象标签

obsutil object-tagging obs://bucket -method=put -tag1 key1=value1 -tag1 keyX=valueX[-tagN keyN=valueN] [-versionId=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

批量设置对象标签

obsutil object-tagging obs://bucket -method=put -r [-f] [-v] -tag1 key1=value1 -tag1 keyX=valueX [-o=xxx] [-j=1] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

macOS/Linux操作系统

设置单个对象标签

./obsutil object-tagging obs://bucket -method=put -tag1 key1=value1 -tag1 keyX=valueX [-tagN keyN=valueN] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

批量设置对象标签

./obsutil object-tagging obs://bucket -method=put -r [-f] [-v] -tag1 key1=value1 -tag1 keyX=valueX [-o=xxx] [-j=1] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例

以Windows操作系统为例，运行obsutil object-tagging obs://test-bucket/key -method=put -tag key1=value1 -tag key2=value2，指定给桶test-bucket下的对象key设置对象标签，分别是key1 value1和 key2 value2。

obsutil object-tagging obs://test-bucket/key -method=put -tag key1=value1 -tag key2=value2 

Start at 2024-09-30 07:59:28.8675681 +0000 UTC

Put tagging object [key] in the bucket [test-bucket] successfully, cost [570] ms, request id [0000019AB61D183F40171C3A0980ACD3]

参数说明

参数	约束	描述
bucket	必选	桶名。
key	可选	待设置对象标签的对象名或对象名前缀。
method	必选	指定方法，设置桶的对象标签时该值为put。
tag	必选	指定对象的标签键值对，格式为key=value。
versionId	附加参数，可选	设置单个对象标签时可指定的对象版本号。
r	附加参数，批量匹配时必选	按设置对象名前缀批量匹配对象。
f	附加参数，批量匹配时可选	强制操作，不进行询问提示。
j	附加参数，批量匹配时可选	批量删除对象时的最大并发数，默认为配置文件中的defaultJobs。说明：工具会保证该值至少为1。
o	附加参数，可选	生成结果清单文件的文件夹，命令执行完成后，会在该文件夹下生成结果清单文件（可能包含成功结果和失败结果两个文件），默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。说明：结果清单文件命名规则：rm_{succeed \| failed}_report_时间_TaskId.txt。单个结果清单文件默认情况下最大为30MB且最大可保留的文件个数为1024，可在配置文件中通过recordMaxLogSize和recordBackups分别配置。当涉及多文件/文件夹时，如需确认失败任务的具体错误信息，可参考结果清单文件夹下的失败结果清单文件“cp_failed_report_时间_TaskId.txt”和日志路径下的日志文件。
config	附加参数，可选	运行当前命令时的自定义配置文件。可支持的配置参数请参考配置参数说明。
e	附加参数，可选	指定终端节点。
i	附加参数，可选	指定用户的AK。
k	附加参数，可选	指定用户的SK。
t	附加参数，可选	指定用户的securitytoken。