PutBucketTags - Object Storage Service - Alibaba Cloud ドキュメントセンター

バケットにタグを追加したり、バケットのタグを変更したりします。

使用上の注意

PutBucketTags操作を呼び出すときは、次の項目に注意してください。

バケットのタグを設定できるのは、バケットの所有者と許可されたRAMユーザーのみです。他のユーザーがバケットのタグを設定しようとすると、403 ForbiddenがエラーコードAccessDeniedと共に返されます。
1つのバケットに最大20個のタグを設定できます。タグはキーと値のペアです。
PutBucketTagsを呼び出してバケットにタグを追加すると、新しいタグは同じキーを持つ既存のタグを上書きします。

リクエスト構文

PUT /? HTTP/1.1のタグ付け
日付: GMT日付
Content-Length: ContentLength
権限付与: SignatureValue
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
<?xml version="1.0" encoding="UTF-8"?>
<タグ付け>
  <TagSet>
    <タグ>
      <キー> key1</キー>
      <Value>value1</Value>
    </Tag>
    <タグ>
      <キー> キー2</キー>
      <Value>value2</Value>
    </タグ>
  </タグセット>
</タグ付け>

リクエストヘッダー

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

リクエスト要素

要素	データ型	必須	説明
タグ付け	Container	必須	TagSetの保存に使用されるコンテナ。子ノード: TagSet 親ノード: なし
タグセット	Container	必須	タグのセットを格納するために使用されるコンテナー。子ノード: タグ親ノード: タグ付け
タグ	Container	必須	追加または変更するタグを格納するために使用されるコンテナー。子ノード: キーと値親ノード: TagSet
キー	STRING	必須	タグのキー。タグキーの長さは最大64バイトです。タグキーの先頭を`http://` 、`https://` 、`Aliyun`にすることはできません。タグキーはUTF-8にエンコードする必要があります。要素の値を空にすることはできません。子ノード: なし親ノード: タグ
値	STRING	任意	タグの値。タグ値の長さは最大128バイトです。タグ値はUTF-8にエンコードする必要があります。このパラメーターは空白のままも可能です。子ノード: なし親ノード: タグ

レスポンスヘッダー

PutBucketTags要求に対する応答には、共通の応答ヘッダーのみが含まれます。詳細については、「共通レスポンスヘッダー」をご参照ください。

例

PUT /? タグ付けのサンプルリクエスト


ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
日付: 火曜日、12月20日2018 11:49:13 GMT
権限付与: OSS qn6qrrqxo2oawuk53otf ****:ceOEyZavKY4QcjoUWYSpYbJ3 ****
<タグ付け>
  <TagSet>
    <タグ>
      <キー> testa</キー>
      <Value>testv1</Value>
    </Tag>
    <タグ>
      <キー> testb</キー>
      <Value>testv2</Value>
    </タグ>
  </タグセット>
</タグ付け>

応答

サンプル200 (OK)
content-length: 0
server: AliyunOSS
x-oss-request-id: 5C1B138A109F4E405B2D ****
日付: 木曜日、12月20日2018 11:59:06 GMT
x-oss-server-time: 148
接続: キープアライブ

OSS SDK

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