所有文档

          标签管理 TAG

          删除标签

          描述

          • 本接口用于删除一个或多个标签
          • 删除标签时若有资源绑定待删除的标签,则会自动解绑
          • 若待删除的标签不存在,则跳过该标签的删除操作
          • 不能删除默认标签。如果待删除的标签的键为"默认标签"值为空字符串,则会跳过对默认标签的删除

          请求

          请求结构

          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
          上一篇
          创建标签
          下一篇
          查看标签下绑定的资源