查询标签键
更新时间 2026-06-16 17:08:51
最近更新时间: 2026-06-16 17:08:51
接口功能介绍
查询标签键。
接口约束
无
URI
POST /dts/v2/open-api/tag/listTagKeys
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池id | 200000001790 |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| pageSize | 否 | Integer | 条数 | 20 | |
| pageNumber | 否 | Integer | 当前页码 | 1 | |
| tagKey | 否 | String | 标签键，支持模糊匹配 | service |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| httpStatusCode | Integer | 状态码 | ||
| errCode | String | 错误码 | ||
| errMessage | String | 提示信息 | ||
| success | Boolean | 请求是否成功 | ||
| requestId | String | 请求id | ||
| data | Array of Objects | 响应数据 | Tag | |
| pageNumber | Integer | 页码 | ||
| pageRecordCount | Integer | 当前页可展示的最大记录数 | ||
| totalRecordCount | Integer | 记录总数 |
表 Tag
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| id | Integer | 标签ID | ||
| tenantId | Integer | 租户ID | ||
| region | String | 所属区域 | ||
| tagKey | String | 标签键 | ||
| tagValue | String | 标签值 | ||
| gmtCreate | String | 创建时间 | ||
| gmtModified | String | 修改时间 | ||
| isDeleted | Boolean | 删除标识 |
枚举参数
无
请求示例
请求url
https://{host}/dts/v2/open-api/tag/listTagKeys
请求头header
无
请求体body
{
"pageSize": 20,
"pageNumber": 1,
"tagKey": "service"
}
响应示例
{
"httpStatusCode": 200,
"errCode": "",
"errMessage": "",
"success": true,
"requestId": "req-20260612-002",
"data": [
{
"id": 1001,
"tenantId": 10001,
"region": "cn-shenzhen",
"tagKey": "service",
"tagValue": "prod",
"gmtCreate": "2026-06-10 09:20:10",
"gmtModified": "2026-06-12 14:10:20",
"isDeleted": false
}
],
"pageNumber": 1,
"pageRecordCount": 10,
"totalRecordCount": 56
}
状态码
请参考 状态码
错误码
请参考 错误码
