# 设置对象标签 #### 功能介绍 设置对象标签。 #### 接口约束 - 您必须是对象拥有者或拥有设置对象标签的权限，才能设置对象标签。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:PutObjectTagging权限，如果使用桶策略则需授予PutObjectTagging权限。相关授权方式介绍可参见[OBS权限控制概述](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0001.html)，配置方式详见[使用IAM自定义策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0121.html)、[自定义创建桶策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0123.html)。 #### 命令结构 - Windows操作系统 - 设置单个对象标签 ``` obsutil object-tagging obs://bucket -method=put -tag key1=value1 -tag keyX=valueX [-tag keyN=valueN] [-versionId=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] ``` - 批量设置对象标签 ``` obsutil object-tagging obs://bucket -method=put -r [-f] [-v] -tag key1=value1 -tag 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 -tag key1=value1 -tag keyX=valueX [-tag keyN=valueN] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx] ``` - 批量设置对象标签 ``` ./obsutil object-tagging obs://bucket -method=put -r [-f] [-v] -tag key1=value1 -tag 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"和日志路径下的[日志文件](https://support.huaweicloud.com/utiltg-obs/obs_11_0056.html)。 | | config | 附加参数，可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。 | | e | 附加参数，可选 | 指定终端节点。 | | i | 附加参数，可选 | 指定用户的AK。 | | k | 附加参数，可选 | 指定用户的SK。 | | t | 附加参数，可选 | 指定用户的securitytoken。 | #### 相关链接 - 关于设置对象标签的API说明，请参见[设置对象标签](https://support.huaweicloud.com/api-obs/obs_04_0172.html)。 - 设置对象标签过程中返回的错误码含义、问题原因及处理措施可参考[OBS错误码](https://support.huaweicloud.com/api-obs/obs_04_0115.html#section1)。