Object Storage Service:PutBucketTags

使用上の注意

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

• バケットの所有者と承認された RAM ユーザーのみが、バケットのタグを設定できます。他のユーザーがバケットのタグを設定しようとすると、エラーコード AccessDenied で 403 Forbidden が返されます。

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

• PutBucketTags を呼び出してバケットにタグを追加すると、新しいタグは同じキーを持つ既存のタグを上書きします。

権限

デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。Alibaba Cloud アカウントの RAM ユーザーまたは RAM ロールは、デフォルトでは権限を持ちません。Alibaba Cloud アカウントまたはアカウントの管理者は、RAM ポリシーまたはバケットポリシーで操作権限を付与する必要があります。

リクエスト構文

PUT /?tagging HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Authorization: SignatureValue
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
<?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>

リクエストヘッダー

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

リクエスト要素

レスポンスヘッダー

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

例

• リクエストの例

  PUT /?tagging
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Thu, 17 Apr 2025 11:49:13 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  <Tagging>
    <TagSet>
      <Tag>
        <Key>testa</Key>
        <Value>testv1</Value>
      </Tag>
      <Tag>
        <Key>testb</Key>
        <Value>testv2</Value>
      </Tag>
    </TagSet>
  </Tagging>

• レスポンスの例

  200 (OK)
  content-length: 0
  server: AliyunOSS
  x-oss-request-id: 5C1B138A109F4E405B2D****
  date: Thu, 20 Dec 2018 11:59:06 GMT
  x-oss-server-time: 148
  connection: keep-alive

OSS SDK

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

• Java

• Python V2

• Go V2

• C++

• Node.js

• .NET

• PHP V2

ossutil

PutBucketTags 操作に対応する ossutil コマンドについては、「put-bucket-tags」をご参照ください。