九游平台/ 对象存储服务 obs/ api参考/ api/ 桶的高级配置/ 设置桶标签
更新时间：2024-11-25 gmt 08:00
查看pdf

设置桶标签-九游平台

功能介绍

obs使用put操作为一个已经存在的桶添加标签。

为桶添加标签后，该桶上所有请求产生的计费话单里都会带上这些标签，从而可以针对话单报表做分类筛选，进行更详细的成本分析。例如：某个应用程序在运行过程会往桶里上传数据，我们可以用应用名称作为标签，设置到被使用的桶上。在分析话单时，就可以通过应用名的标签来分析此应用的成本。

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

接口约束

  • 每个桶最多能设置10个标签。

请求消息样式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
 
put/?tagginghttp/1.1
host:bucketname.obs.cn-north-4.myhuaweicloud.com
date:date
authorization:authorizationstring
content-md5:md5



tagname
tagvalue

请求消息参数

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

请求消息头

该请求使用的消息头如下表1所示。

表1 请求消息头

消息头名称

描述

是否必选

content-md5

参数解释：

按照rfc 1864标准计算出消息体的md5摘要字符串，即消息体128-bit md5值经过base64编码后得到的字符串。也支持设置content-sha256头域，其值为消息体256-bit sha256值经过base64编码后得到的字符串，content-md5和content-sha256二选一。

类型：string

示例：n58ig6hfm7vqi4k0vnwpog==

约束限制：

无

取值范围：

无

默认取值：

无

是

请求消息元素

在此请求中，需要在请求的消息体中配置桶的标签。标签的配置信息以xml格式上传。具体的配置元素如表2。

表2 桶的标签配置元素

消息头名称

描述

是否必选

tagging

参数解释：

tagset和tag的根元素

类型：container

父元素：无

是

tagset

参数解释：

tag的集合元素

类型：container

父元素：tagging

是

tag

参数解释：

tag的信息元素

类型：container

父元素：tagset

是

key

参数解释：

标签的名字。类型：string。父元素：tag

约束限制：

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

取值范围：

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

默认取值：

无

是

value

参数解释：

标签的值。类型：string。父元素：tag

约束限制：

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

取值范围：

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

默认取值：

无

是

响应消息样式

1
2
3
4
5
 
http/1.1status_code
x-obs-request-id:requestid
x-obs-id-2:id
content-length:length
date:date

响应消息头

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

响应消息元素

该请求的响应消息中不带有响应元素。

错误响应消息

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

表3 配置桶标签错误码列表

错误码

描述

http状态码

invalidtagerror

配置桶标签时，提供了无效的tag。

400 bad request

malformedxmlerror

配置桶标签时，提供的xml格式错误

400 bad request

请求示例

例如要为桶名为examplebucket的桶打上键名（key）为tagkey(name1)，键值（value）为tagvalue(value1)的标签，则发送的请求为：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
 
put/?tagginghttp/1.1
user-agent:curl/7.29.0
host:examplebucket.obs.cn-north-4.myhuaweicloud.com
accept:*/*
date:wed,27jun201813:22:50gmt
authorization:obsh4ipjx0tqththebqqcec:pf1zygvvyg2bzojokz/baer1meq=
content-md5:mnaevkfqignbpchoe2u6og==
content-length:182
xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/">


tagkey(name1)
tagvalue(value1)

响应示例

1
2
3
4
5
 
http/1.1204nocontent
server:obs
x-obs-request-id:bf26000001643feba09b1ed46932cd07
x-obs-id-2:32aaaqaaeaabsaagaaeaabaaaqaaeaabcsezp87ieirc6dggpb5cn49psvhbwclg
date:wed,27jun201813:22:50gmt
父主题： 桶的高级配置

相关文档

网站地图