全部产品
Search
文档中心

对象存储 OSS:GetBucketTags

更新时间:Aug 24, 2023

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 qn6qrrqxo2oawuk53otf****:ceOEyZavKY4QcjoUWYSpYbJ3****
  • 返回示例

    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的标签信息。