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

この操作を呼び出して、バケットに設定されているタグをクエリできます。

リクエスト構文

GET /? tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

注意事項

oss:GetBucketTagging の権限が必要です。 GetBucketTags 操作を呼び出してバケットのタグ情報を取得するには。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。

レスポンス要素

要素	タイプ	説明
Tagging	コンテナー	バケットの返されたタグを格納するコンテナー。親ノード: なし説明バケットにタグが設定されていない場合は、Tagging 要素が空の XML メッセージ本文が返されます。
TagSet	コンテナー	バケットの返されたタグを格納するコンテナー。親ノード: なし
Tag	コンテナー	バケットの返されたタグを格納するコンテナー。親ノード: TagSet
Key	文字列	タグのキー。親ノード: Tag
Value	文字列	タグの値。親ノード: Tag

例

サンプルリクエスト

GET /? tagging
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 20 Dec 2018 13:09:13 GMT
Authorization: OSS qn6q**************:77Dv****************

サンプルレスポンス

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

以下のプログラミング言語の OSS SDK を使用して、GetBucketTags 操作を実行できます。

ossutil

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

エラーコード

エラーコード	HTTP ステータスコード	説明
NoSuchBucket	404	指定されたバケットが存在しないために返されるエラーメッセージです。
AccessDenied	403	バケットに設定されているタグを照会する権限がないために返されるエラーメッセージです。バケットオーナーのみが、バケットに設定されているタグを照会できます。