Object Storage Service:PutObjectTagging

使用上の注意

• オブジェクトには最大10個のタグを追加できます。 オブジェクトに追加されるタグには、一意のタグキーが必要です。

• タグキーの長さは最大128文字です。 タグ値の長さは最大256文字です。

• タグキーとタグ値は大文字と小文字を区別します。

• タグのキーと値には、英数字、スペース、および次の特殊文字を含めることができます。

  + - = . _ : /

  HTTPヘッダーのタグに文字が含まれている場合は、タグのキーと値に対してURLエンコードを実行する必要があります。

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

オブジェクトタグの詳細については、「オブジェクトタグの設定」をご参照ください。

バージョン管理

既定では、PutObjectTaggingを呼び出してオブジェクトにタグを追加したり、オブジェクトに設定されたタグを更新したりすると、タグがオブジェクトの現在のバージョンに追加されるか、オブジェクトの現在のバージョンに設定されたタグが更新されます。 リクエストでversionIdパラメーターを指定して、指定したバージョンのオブジェクトにタグを追加したり、指定したバージョンのオブジェクトに設定されたタグを更新したりできます。 指定されたバージョンが削除マーカーの場合、OSSは404 Not Foundを返します。

リクエスト構文

PUT /objectname? タグ付け
コンテンツ-長さ: 114
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: 3月18日月曜日2019 08:25:17 GMT
権限付与: SignatureValue
<タグ付け>
  <TagSet>
    <タグ>
      <キー> キー </キー>
      <Value> 値 </Value>
    </タグ>
  </タグセット>
</タグ付け> 

リクエスト要素

この操作には、共通のリクエストヘッダーも含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。

例

• 非バージョン化バケット内のオブジェクトにタグを追加する

  この例では、objectnameという名前のオブジェクトは、bucketnameという名前の未バージョンのバケットに格納されます。 {A: 1} および {b:2} タグをobjectnameという名前のオブジェクトに追加するために、PutObjectTaggingリクエストが送信されます。 2つのタグがオブジェクトに追加されると、200 (OK) が返されます。

  リクエストの例

  PUT /objectname? タグ付け
  コンテンツ-長さ: 114
  ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
  日付: 3月18日月曜日2019 08:25:17 GMT
  承認: OSS qn6qrrqxo2oawuk53otf ****:77Dvh 5wQgIjWjwO/KyRt8dOP ****
  <タグ付け>
    <TagSet>
      <タグ>
        <キー> a</キー>
        <値> 1</値>
      </Tag>
      <タグ>
        <キー> b</キー>
        <値> 2</値>
      </タグ>
    </タグセット>
  </タグ付け> 

  レスポンスの例

  200 (OK)
  content-length: 0
  server: AliyunOSS
  接続: キープアライブ
  x-oss-request-id: 5C8F55ED461FB4A64C00 ****
  日付: 3月18日月曜日2019 08:25:17GMT 

• バージョン管理が有効なバケット内のオブジェクトにタグを追加する

  この例では、objectnameという名前のオブジェクトがbucketnameという名前のバージョン付きバケットに格納されます。 {age:18} タグをobjectnameの指定されたバージョンに追加するために、PutObjectTaggingリクエストが送信されます。 タグがオブジェクトに追加されると、200 (OK) が返されます。

  リクエストの例

  PUT /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0 ****
  コンテンツ-長さ: 90
  ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
  日付: 6月24日水曜日2020 08:58:15 GMT
  承認: OSS qn6qrrqxo2oawuk53otf ****:77Dvh 5wQgIjWjwO/KyRt8dOP ****
  <タグ付け>
    <TagSet>
      <タグ>
        <キー> 年齢 </キー>
        <値> 18</値>
      </タグ>
    </タグセット>
  </タグ付け> 

  レスポンスの例

  200 (OK)
  content-length: 0
  server: AliyunOSS
  接続: キープアライブ
  x-oss-request-id: 5EF315A7FBD3EC3232B4 ****
  日付: 6月24日水曜日2020 08:58:15 GMT
  x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0 **** 

SDK

次のプログラミング言語のOSS SDKを使用して、PutObjectTagging操作を呼び出すことができます。

• Java

• Python

• 行く

• C ++

• . NET

• Node.js

エラーコード