給某個儲存空間添加或修改標籤。 - Object Storage Service

put-bucket-tags用於給某個儲存空間（Bucket）添加或修改標籤。

注意事項

阿里雲帳號預設擁有為Bucket添加或修改標籤的許可權。如果您需要通過RAM使用者或者STS的方式進行添加修改，您必須擁有oss:PutBucketTags許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。
put-bucket-tags是覆蓋語義，即新添加的標籤會完全覆蓋已有的標籤。
最多可設定20對Bucket使用者標籤。

命令格式

ossutil api put-bucket-tags --bucket value --tagging value [flags]

參數	類型	說明
--bucket	string	Bucket的名稱。
--tagging	string	設定Bucket TagSet的容器。

說明

put-bucket-tags命令對應API介面PutBucketTags。關於API中的具體參數含義，請參見PutBucketTags。

--tagging

--tagging配置選項既支援XML文法也支援JSON文法，當選項值包含file://首碼時，表示從檔案中讀取配置。

XML文法：

<Tagging>
  <TagSet>
    <Tag>
      <Key>string</Key>
      <Value>string</Value>
    </Tag>
    ...
  </TagSet>
</Tagging>

JSON文法：

{
  "TagSet": {
    "Tag": [
      {
        "Key": "string",
        "Value": "string"
      },
      ...
    ]
  }
}

說明

關於支援的全域命令列選項，請參見支援的全域命令列選項。

使用樣本

以下樣本展示了如何為儲存空間examplebucket添加或修改標籤。

使用XML設定檔，tagging.xml內容如下：

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>key1</Key>
      <Value>value1</Value>
    </Tag>
    <Tag>
      <Key>key2</Key>
      <Value>value2</Value>
    </Tag>
  </TagSet>
</Tagging>

命令樣本如下：

ossutil api put-bucket-tags --bucket examplebucket --tagging file://tagging.xml

使用JSON設定檔，tagging.json內容如下：

{
    "TagSet": {
        "Tag": [
            {
                "Key": "key1",
                "Value": "value1"
            },
            {
                "Key": "key2",
                "Value": "value2"
            }
        ]
    }
}

命令樣本如下：

ossutil api put-bucket-tags --bucket examplebucket --tagging file://tagging.json

使用JSON配置參數，命令樣本如下：

ossutil api put-bucket-tags --bucket examplebucket --tagging "{\"TagSet\":{\"Tag\":[{\"Key\":\"key1\",\"Value\":\"value1\"},{\"Key\":\"key2\",\"Value\":\"value2\"}]}}"