描述
- 本接口用于删除一个或多个标签。
- 删除标签时若有资源绑定待删除的标签，则会自动解绑。
- 若待删除的标签不存在，则跳过该标签的删除操作。
- 不能删除默认标签。如果待删除的标签的键为"默认标签"值为空字符串，则会跳过对默认标签的删除。
请求
请求结构
PUT /v{version}/tag?delete 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?delete 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