如何通過bucket-tagging命令增刪改查標籤配置 - Object Storage Service

您可以通過儲存空間（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****

關於此命令的其他通用選項的更多資訊，請參見通用選項。