注意:更多授权请参见 支持 CAM 的业务接口。
一、命令格式
./coscli bucket-tagging –method [method] cos://<bucket-name> [tag_key]#[tag_value]
bucket-tagging 命令包含以下参数:
| 参数格式 | 参数用途 | 示例 |
| cos://<bucket-name> | 指定需要访问的存储桶。支持使用 配置参数 中的桶别名,或桶名称进行访问。如使用桶名称访问,需要额外携带 endpoint flag | 使用桶别名访问:cos://example-alias使用桶名称访问:cos://examplebucket-1250000000 |
bucket-tagging 命令包含以下可选 flag:
| flag 简写 | flag 全称 | flag 用途 |
| -h | –help | 查看该命令的具体用法 |
| 无 | –method | 指定需要进行的操作,包括 put(设置标签)、get(查询标签)、delete(删除标签)、add(添加标签) |
注意:说明:
注意:关于此命令的其他通用选项(例如切换存储桶、切换用户账号等),请参见 通用选项 文档。
二、设置存储桶标签
存储桶标签用一组键值对(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