存储桶标签 - bucket-tagging

注意：

如需获取存储桶标签，在您进行 授权策略 时，action 需要设置为 cos:GetBucketTagging。

如需设置存储桶标签，在您进行 授权策略 时，action 需要设置为 cos:PutBucketTagging。

如需删除存储桶标签，在您进行 授权策略 时，action 需要设置为 cos:DeleteBucketTagging。

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

命令格式

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

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

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

说明：

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

设置存储桶标签

存储桶标签用一组键值对（Key-Value）来表示，只有存储桶所有者及拥有 PutBucketTagging 权限的用户才可以设置存储桶标签，否则会返回错误码 403 AccessDenied。

命令格式

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

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

操作示例

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

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

查询存储桶标签

命令格式

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

操作示例

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

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

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

删除存储桶所有标签

命令格式

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

操作示例

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

添加存储桶标签

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

命令格式

./coscli bucket-tagging --method add cos://bucketAlias key1#value1 key2#value2

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

操作示例

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

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