描述
- 本接口用于列出所有符合条件的标签下绑定的资源。
- 若符合条件的标签下无资源，则该标签不出现的返回结果中。
- 本接口返回绑定的资源id，资源详情可通过各产品API查询。
请求
请求结构
GET /v{version}/tag/tagResources?tagKey={tagkey}&tagValue={tagValue}®ion={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®ion=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"
}
]
}
]
}