查看标签下绑定的资源
所有文档

          标签管理 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列表