标签管理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
    上一篇
    域名
    下一篇
    删除标签