创建标签
所有文档

          标签管理 TAG

          创建标签

          描述

          • 本接口用于创建一个或多个标签
          • 为具体产品资源绑定标签请参考各产品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
          上一篇
          域名
          下一篇
          删除标签