描述
- 本接口用于列出所有符合条件的标签键值对。
- 标签的键和标签的值可以作为筛选条件。
- 本接口返回所有符合条件的结果，不分页。
请求
请求结构
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"
}
]
}