创建标签
更新时间：2020-06-23
描述
- 本接口用于创建一个或多个标签
- 为具体产品资源绑定标签请参考各产品API
- 若待创建的标签已经存在，则跳过该标签的创建操作
- 标签的键和值需要符合规范，具体规则见Tag，且标签的键不能为空
请求
请求结构
Plain Text
1PUT /v{version}/tag?create HTTP/1.1
2Host: tag.baidubce.com
3Authorization: authorization string
4
5{
6 "tags": [
7 {
8 "tagKey": tagKey,
9 "tagValue": tagValue
10 }
11 ]
12}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| tags | List<Tag> | 是 | Request Body参数 | 待创建的标签键值对列表 |
返回
返回头域
除公共头域，无其它特殊头域。
返回参数
无特殊返回参数
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| TagExceptions.TagKeyInvalid | Tag key contains invalid characters or length exceeds limit. | 400 | 标签键含有非法字符或长度超过限制 |
| TagExceptions.TagValueInvalid | Tag value contains invalid characters or length exceeds limit. | 400 | 标签值含有非法字符或长度超过限制 |
| TagExceptions.TagKeyEmpty | Tag key should not be empty. | 400 | 标签键不能为空 |
| TagExceptions.TagEmpty | Tag should not be empty. | 400 | 标签不能为空 |
| TagExceptions.LimitExceeded | Limit exceeded for current request. | 413 | 标签创建总数超过限制 |
示例
请求示例
Plain Text
1PUT /v1/tag?create HTTP/1.1
2Host: tag.baidubce.com
3Authorization: authorization string
4
5{
6 "tags": [
7 {
8 "tagKey": "key1",
9 "tagValue": "value1"
10 },
11 {
12 "tagKey": "key2",
13 "tagValue": "value2"
14 }
15 ]
16}返回示例
Plain Text
1cache-control: no-cache
2content-length: 0
3content-type: text/plain; charset=utf-8
4date: Mon, 09 Apr 2018 09:14:41 GMT
5server: BWS
6x-bce-request-id: 602b9cda-d803-433b-b902-c6f787ebb7fc