全部產品
Search
文件中心

:GetBucketTags

更新時間:Jun 19, 2024

GetBucketTags用於擷取儲存空間(Bucket)的標籤資訊。

請求文法

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

響應元素

名稱

類型

描述

Tagging

容器

儲存Bucket Tag結果的容器。

父元素:無

說明

如果源Bucket未設定Tag,OSS仍返回一個XML訊息體,但其中的Tagging元素為空白。

TagSet

容器

儲存Bucket Tag結果的容器。

父元素:Tagging

Tag

容器

儲存Bucket Tag結果的容器。

父元素:TagSet

Key

字串

某個Tag的Key。

父元素:Tag

Value

字串

某個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>

SDK

此介面所對應的各語言SDK如下:

錯誤碼

錯誤碼

HTTP狀態代碼

描述

NoSuchBucket

404

目標Bucket不存在。

AccessDenied

403

沒有查看Bucket標籤的許可權。只有Bucket的擁有者及授權子賬戶才能查看Bucket的標籤資訊。