文档首页/ 对象存储服务 OBS/ API参考/ API/ 桶的高级配置/ 获取桶标签
更新时间：2025-08-22 GMT+08:00
查看PDF
分享

获取桶标签

功能介绍

OBS使用GET操作来获取指定桶的标签。

要正确执行此操作，需要确保执行者有GetBucketTagging权限。缺省情况下只有桶的所有者可以执行此操作，也可以通过设置桶策略或用户策略授权给其他用户。

请求消息样式

1
2
3
4
 
GET /?tagging HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com 
Date: date
Authorization: authorization string

请求消息参数

该请求消息中不使用消息参数。

请求消息头

该请求使用公共消息头，具体参见表3。

请求消息元素

此请求消息中不使用消息元素。

响应消息样式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
 
HTTP/1.1 status_code
x-obs-request-id: request id
x-obs-id-2: id
Content-Type: application/xml 
Content-Length: length
Date: date
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<Tagging xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
    <TagSet> 
        <Tag> 
            <Key>key</Key> 
            <Value>value</Value> 
        </Tag> 
    </TagSet> 
</Tagging>

响应消息头

该请求的响应消息使用公共消息头，具体请参考表1。

响应消息元素

在此请求返回的响应消息体中包含的配置元素如下表1。

表1 桶的标签配置元素

消息头名称

参数类型

描述

Tagging

XML

参数解释：

TagSet和Tag的父元素。

约束限制：

不涉及

TagSet

XML

参数解释：

Tag的父元素。父元素：Tagging

约束限制：

每个桶最多能设置20个标签，即TagSet下最多有20个Tag节点。

Tag

XML

参数解释：

Tag的信息元素。父元素：TagSet

约束限制：

每个桶最多能设置20个标签，即TagSet下最多有20个Tag节点。

Key

String

参数解释：

标签的名字。父元素：Tag

约束限制：

  • 标签的键名（Key）的最大长度为36个字符。
  • 标签的键名（Key）和键值（Value）不能包含字符“,”、“*”、“|”、“/”、“<”、“>”、“=”、“\”以及ASCII码0x00--0x1F的控制字符，在发送到服务器之前，必须将键名（Key）和键值（Value）进行UrlEncode编码。

取值范围：

长度大于1小于36的字符串

默认取值：

无

Value

String

参数解释：

标签的值。父元素：Tag

约束限制：

  • 标签的键值（Value）的最大长度为43个字符。
  • 标签的键名（Key）和键值（Value）不能包含字符“,”、“*”、“|”、“/”、“<”、“>”、“=”、“\”以及ASCII码0x00--0x1F的控制字符，在发送到服务器之前，必须将键名（Key）和键值（Value）进行UrlEncode编码。

取值范围：

长度大于等于0小于43的字符串。

默认取值：

无

错误响应消息

除了公共的错误码外，此接口还会返回一些其他的错误码。下表中列出本接口的一些常见错误，以及可能原因。如表2。

表2 配置桶标签的错误码列表

错误码

描述

HTTP状态码

NoSuchTagSet

指定的桶没有设置标签

404 Not Found

请求示例

1
2
3
4
5
6
 
GET /?tagging HTTP/1.1   
User-Agent: curl/7.29.0   
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*   
Date: Wed, 27 Jun 2018 13:25:44 GMT  
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:H1INcyc5i0XlHqYTfuzkPxLZUPM=

响应示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
 
HTTP/1.1 200 OK 
x-obs-request-id: 0002B7532E0000015BEB35330C5884X1 
x-obs-id-2: s12w20LYNQqSb7moq4ibgJwmQRSmVQV+rFBqplOGYkXUpXeS/nOmbkyD+E35K79j 
Content-Type: application/xml 
Date: Wed, 27 Jun 2018 13:25:44 GMT 
Content-Length: 441 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Tagging xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <TagSet>
    <Tag>
      <Key>TagName1</Key>
      <Value>TageSetVaule1</Value>
    </Tag>
  </TagSet>
</Tagging>
父主题： 桶的高级配置