Object Storage Service:put-object-tagging

使用上の注意

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

• オブジェクトに追加される各タグは、キーと値のペアです。 オブジェクトには最大10個のタグを追加できます。 オブジェクトに追加されるタグには、一意のタグキーが必要です。 タグキーの長さは最大128文字です。 タグ値の長さは最大256文字です。 タグキーと値は大文字と小文字を区別します。 タグのキーと値には、英数字、スペース、および次の特殊文字を含めることができます: +-=._:/。

• オブジェクトのタグを編集しても、オブジェクトのLast-Modifiedパラメーターは更新されません。

コマンド構文

ossutil api put-object-tagging --bucket value --key value --tagging value [flags]

-- タグ付け

-- tagging設定オプションは、XML形式とJSON形式の両方をサポートします。 オプションの値に 'file:// 'プレフィックスが含まれている場合、設定パラメーターは指定されたファイルから読み取られます。

• XML 形式：

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

• JSON 形式：

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

例

exampleobjectのタグを追加または編集します。

• 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-object-tagging --bucket examplebucket --key exampleobject --tagging file://tagging.xml

• tagging.jsonという名前の設定ファイルを作成し、次のコードを追加します。

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

  サンプルコマンド:

  ossutil api put-object-tagging --bucket examplebucket --key exampleobject --tagging file://tagging.json

• 次のコマンドでパラメーターをJSON形式で設定します。

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