对象标签 - object-tagging

注意：

如需查询对象标签，在您进行 授权策略 时，action 需要设置为 cos:GetObjectTagging。

如需设置对象标签，在您进行 授权策略 时，action 需要设置为 cos:PutObjectTagging。

如需删除对象标签，在您进行 授权策略 时，action 需要设置为 cos:DeleteObjectTagging。

更多授权请参见 支持 CAM 的业务接口。

命令格式

./coscli object-tagging --method [method] cos://<bucket-name>/object [tag_key]#[tag_value]

object-tagging 命令包含以下参数：

object-tagging 命令包含以下可选 flag：

说明：

关于此命令的其他通用选项（例如切换存储桶、切换用户账号等），请参见 通用选项 文档。

修改对象标签

对象标签用一组键值对（Key-Value）来表示，只有对象所有者及拥有 PutObjectTagging 权限的用户才可以添加或修改对象标签，否则会返回错误码 403 AccessDenied。

命令格式

./coscli object-tagging --method put cos://bucketAlias/object key1#value1 key2#value2

其中，key#value表示标签键值对 Key-Value，key 和 value 之间以#分隔。若对象未设置标签，此命令将为对象添加指定的标签；若对象已设置标签，此命令将覆盖原有的标签。

操作示例

为桶别名为 example-alias下的 object 对象配置两组标签，其中一组标签的 key 为1，value 为111，一组标签的 key 为2，value 为222。命令如下：

./coscli object-tagging --method put cos://example-alias/object 1#111 2#222

查询对象标签

命令格式

./coscli object-tagging --method get cos://bucketAlias/object

操作示例

./coscli object-tagging --method get cos://example-alias/object

以下输出结果表明桶别名为 example-alias下的 object  对象配置了两组标签，其中一组标签的 key 为1，value 为111，一组标签的 key 为2，value 为222。

  KEY | VALUE  ------+--------    1 |   111      2 |   222 

删除对象指定标签

命令格式

./coscli object-tagging --method delete cos://bucketAlias/object key1#value1

操作示例

./coscli object-tagging --method delete cos://example-alias/object 1#111

删除对象所有标签

命令格式

./coscli object-tagging --method delete cos://bucketAlias/object

操作示例

./coscli object-tagging --method delete cos://example-alias/object

添加对象标签

对象标签用一组键值对（Key-Value）来表示，只有对象所有者及拥有 PutObjectTagging 权限的用户才可以添加或修改对象标签，否则会返回错误码 403 AccessDenied。

命令格式

./coscli object-tagging --method add cos://bucketAlias/object key3#value3

其中，key#value表示标签键值对 Key-Value，key 和 value 之间以#分隔。

操作示例

为桶别名为 example-alias下的 object 对象添加一组标签，标签的 key 为1，value 为111。命令如下：

./coscli object-tagging --method add cos://example-alias/object 1#111