标签管理TAG

    tag列表

    描述

    • 本接口用于列出所有符合条件的标签键值对
    • 标签的键和标签的值可以作为筛选条件
    • 本接口返回所有符合条件的结果,不分页

    请求

    请求结构

    GET /v{version}/tag?tagKey={tagkey}&tagValue={tagValue} HTTP/1.1
    Host: tag.baidubce.com
    Authorization: authorization string

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号
    tagKey String Query参数 待查询的标签键,该项不出现或为空表示查询所有标签键
    tagValue String Query参数 待查询的标签值,该项不出现表示查询所有标签值,为空表示待查询的标签值为空字符串

    返回

    返回头域

    除公共头域,无其它特殊头域。

    返回参数

    参数名称 类型 描述
    tags List<Tag> 符合条件的标签键值对列表,若无符合条件的标签,则返回空数组

    错误码

    无特殊返回错误码

    示例

    请求示例

    GET /v1/tag?tagKey=key1 HTTP/1.1
    Host: tag.baidubce.com
    Authorization: bce-auth-v1/5004fa6158924aa3a752f6897782af8d/2018-04-09T00:00:00Z/1800/host/807f9b9a5bc5c0f38fd184582f1b4028a736687864df86440c443282ddb4ca9e

    返回示例

    cache-control: no-cache
    content-length: 0
    content-type: text/plain; charset=utf-8
    date: Mon, 09 Apr 2018 00:00:00 GMT
    server: BWS
    x-bce-request-id: ec40cddb-b5d0-45ae-9325-2822ece684cf
    
    {
        "tags": [
            {
                "tagKey": "key1",
                "tagValue": "value1"
            }
        ]
    }
    上一篇
    查看标签下绑定的资源
    下一篇
    附录1