查看标签下绑定的资源
更新时间:2020-06-23
描述
- 本接口用于列出所有符合条件的标签下绑定的资源
- 若符合条件的标签下无资源,则该标签不出现的返回结果中
- 本接口返回绑定的资源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"
}
]
}
]
}