标签管理TAG

    查看标签下绑定的资源

    描述

    • 本接口用于列出所有符合条件的标签下绑定的资源
    • 若符合条件的标签下无资源,则该标签不出现的返回结果中
    • 本接口返回绑定的资源id,资源详情可通过各产品API查询

    请求

    请求结构

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

    请求头域

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

    请求参数

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

    返回

    返回头域

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

    返回参数

    参数名称 类型 描述
    tagResources List<TagResource> 符合条件的标签及其对应的资源列表,若无符合条件的标签,则返回空数组

    错误码

    无特殊返回错误码

    示例

    请求示例

    GET /v1/tag/tagResources?tagKey=key1&tagValue=value1&region=bj HTTP/1.1 HTTP/1.1
    Host: tag.baidubce.com
    Authorization: bce-auth-v1/62f0900586964cb2b76bcd221969eb0f/2018-04-09T00:00:00Z/1800/host/36e62c42e473576adb1510edf64dfd6e685982b833de9c657594ca7e78da0401

    返回示例

    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: 160c0ea9-134e-45af-83c8-c17cea8443fa
    
    {
        "tagResources": [
            {
                "tagKey": "key1",
                "tagValue": "value1",
                "resources": [
                    {
                        "resourceType": "BCC",
                        "resourceId": "i-WosX2TgK",
                        "region": "bj"
                    },
                    {
                        "resourceType": "BOS",
                        "resourceId": "tag-test",
                        "region": "bj"
                    }
                ]
            }
        ]
    }
    上一篇
    删除标签
    下一篇
    tag列表