この操作を呼び出して、バケットに設定されているタグを照会できます。
リクエスト構文
GET /? tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue注意事項
GetBucketTags 操作を呼び出してバケットのタギング情報を取得するには、oss:GetBucketTagging の権限が必要です。詳細については、「Grant a custom policy」をご参照ください。
応答要素
|
要素 |
型 |
説明 |
|
Tagging |
コンテナ |
バケットの返されるタグを格納するコンテナです。 親ノード：なし 説明
バケットにタグが設定されていない場合、Tagging 要素が空の XML メッセージ本文が返されます。 |
|
TagSet |
コンテナ |
バケットの返されるタグを格納するコンテナです。 親ノード：Tagging |
|
Tag |
コンテナ |
バケットの返される 1 つのタグを格納するコンテナです。 親ノード：TagSet |
|
Key |
文字列 |
タグのキーです。 親ノード：Tag |
|
Value |
文字列 |
タグの値です。 親ノード：Tag |
例
-
リクエストのサンプル
GET /? tagging Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Thu, 17 Apr 2025 13:09:13 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e -
応答のサンプル
200 (OK) content-length: 237 server: AliyunOSS x-oss-request-id: 5C1B2D24B90AD5490CFE368E date: Thu, 20 Dec 2018 13:12:21 GMT content-type: application/xml <?xml version="1.0" encoding="UTF-8"?> <Tagging> <TagSet> <Tag> <Key>testa</Key> <Value>value1-test</Value> </Tag> <Tag> <Key>testb</Key> <Value>value2-test</Value> </Tag> </TagSet> </Tagging>
OSS SDK
GetBucketTags 操作は、次のプログラミング言語の OSS SDK を使用して呼び出すことができます。
ossutil
GetBucketTags 操作に対応する ossutil コマンドについては、「get-bucket-tags」をご参照ください。
エラーコード
|
エラーコード |
HTTP ステータスコード |
説明 |
|
NoSuchBucket |
404 |
指定されたバケットが存在しない場合に返されるエラーメッセージです。 |
|
AccessDenied |
403 |
バケットに設定されているタグを照会する権限がない場合に返されるエラーメッセージです。バケット所有者のみがバケットに設定されているタグを照会できます。 |