Object Storage Service:put-bucket-tags

使用上の注意

• デフォルトでは、Alibaba Cloudアカウントには、バケットのタグを追加または変更する権限があります。 RAMユーザーまたはSecurity Token Service (STS) を使用してバケットのタグを追加または変更するには、oss:PutBucketTags権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

• put-bucket-tagsコマンドを実行してバケットにタグを追加すると、新しいタグが既存のタグを上書きします。

• 1つのバケットに最大20個のタグを設定できます。 タグはキーと値のペアです。

コマンド構文

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

-- タグ付け

-- taggingオプションは、XML形式とJSON形式の両方をサポートします。 オプションの値にfile:// プレフィックスが含まれている場合、ossutilは構成ファイルから構成を読み取ります。

• XML 形式：

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

• JSON 形式：

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

例

次の例は、examplebucketという名前のバケットのタグを追加または変更する方法を示しています。

• 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

• 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\"}]}}"