如何通过bucket-tagging命令增删改查标签配置 - 对象存储 OSS

您可以通过存储空间（Bucket）的标签功能，对Bucket进行分类管理，例如对拥有指定标签的Bucket设置访问权限等。bucket-tagging命令用于添加、修改、查询、删除Bucket的标签配置。

注意事项

要添加或修改Bucket标签，您必须具有oss:PutBucketTagging权限；要获取Bucket标签，您必须具有oss:GetBucketTagging权限；要删除Bucket标签，您必须具有oss:DeleteBucketTagging权限。具体操作，请参见为RAM用户授权自定义的权限策略。

从ossutil 1.6.16版本开始，命令行中Binary名称支持直接使用ossutil，您无需根据系统刷新Binary名称。如果您的ossutil版本低于1.6.16，则需要根据系统刷新Binary名称。更多信息，请参见命令行工具ossutil命令参考。
关于Bucket标签的更多信息，请参见管理存储空间标签。

添加或修改Bucket标签

存储空间标签使用一组键值对（Key-Value）来标记Bucket，每个Bucket仅允许添加10组标签。只有Bucket的拥有者以及被授予PutBucketTags权限的用户才能为Bucket添加或修改标签，否则返回403 Forbidden错误，错误码为AccessDenied。

命令格式

ossutil bucket-tagging --method put oss://bucketname key#value

参数说明如下：

参数

说明

bucketname

添加或修改标签信息的Bucket名称。

key#value

标签信息的Key-Value对。

Key和Value以井号（#）分隔，且Key和Value必须为UTF-8编码。
Key最大长度为64字符，不能以http://、https://、Aliyun为前缀，且不能为空。
Value最大长度为128字符，可以为空。

若Bucket未设置标签，此命令将为Bucket添加指定的标签；若Bucket已设置标签，此命令将覆盖Bucket已有标签。

使用示例
为名为examplebucket的Bucket配置两组标签，其中一组标签的Key为tag1，Value为test1；另一组标签的Key为tag2，Value为test2。
```
ossutil bucket-tagging --method put oss://examplebucket  tag1#test1 tag2#test2
```
以下输出结果表明已成功添加Bucket标签信息。
```
0.300600(s) elapsed
```

获取Bucket标签

命令格式

ossutil bucket-tagging --method get oss://bucketname

使用示例

获取examplebucket的标签配置。

ossutil bucket-tagging --method get oss://examplebucket

以下输出结果表明examplebucket配置了两组标签，其中一组标签的Key为tag1，Value为test1；另一组标签的Key为tag2，Value为test2。

index     tag key       tag value
---------------------------------------------------
0         "tag1"        "test1"
1         "tag2"        "test2"

0.283359(s) elapsed

删除Bucket标签

命令格式

ossutil bucket-tagging --method delete oss://bucketname

使用示例
删除examplebucket所有包含的标签信息。
说明
ossutil仅支持批量删除Bucket中包含的所有标签，不支持删除Bucket中的指定标签。您可以调用DeleteBucketTags接口删除Bucket中的指定标签。
```
ossutil bucket-tagging --method delete oss://examplebucket
```
以下输出结果表明examplebucket中包含的所有标签信息均已删除。
```
0.530750(s) elapsed
```

通用选项

当您需要通过命令行工具ossutil切换至另一个地域的Bucket时，可以通过-e选项指定该Bucket所属的Endpoint。当您需要通过命令行工具ossutil切换至另一个阿里云账号下的Bucket时，可以通过-i选项指定该账号的AccessKey ID，并通过-k选项指定该账号的AccessKey Secret。

例如您需要为另一个阿里云账号下，华东1（杭州）名为examplebucket的存储空间配置标签信息，命令如下：

ossutil bucket-tagging--method put oss://examplebucket key#value -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA****  -k 67DLVBkH7EamOjy2W5RVAHUY9H****

关于此命令的其他通用选项的更多信息，请参见通用选项。