描述
- 本接口用于创建一个或多个标签。
- 为具体产品资源绑定标签请参考各产品API。
- 若待创建的标签已经存在，则跳过该标签的创建操作。
- 标签的键和值需要符合规范，具体规则见Tag，且标签的键不能为空。
请求
请求结构
PUT /v{version}/tag?create HTTP/1.1
Host: tag.baidubce.com
Authorization: authorization string
{
"tags": [
{
"tagKey": tagKey,
"tagValue": tagValue
}
]
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| 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 | 标签创建总数超过限制 |
示例
请求示例
PUT /v1/tag?create HTTP/1.1
Host: tag.baidubce.com
Authorization: authorization string
{
"tags": [
{
"tagKey": "key1",
"tagValue": "value1"
},
{
"tagKey": "key2",
"tagValue": "value2"
}
]
}返回示例
cache-control: no-cache
content-length: 0
content-type: text/plain; charset=utf-8
date: Mon, 09 Apr 2018 09:14:41 GMT
server: BWS
x-bce-request-id: 602b9cda-d803-433b-b902-c6f787ebb7fc