巡检项:查询巡检项列表
更新时间 2026-09-08 16:27:14
最近更新时间: 2026-09-08 16:27:14
接口功能介绍
调用此接口可查询巡检项列表。
接口约束
参见请求参数说明。
URI
POST /v4/monitor/cloud-inspection/query-strategies
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| category | 否 | String | 本参数表示巡检项类别。取值范围: security:安全。 reliability:可靠。 performance:性能。 cost:成本。 service_limits:服务限制。 根据以上范围取值。 | security | |
| service | 否 | String | 云监控服务,具体服务参见云监控:查询服务维度及监控项 | ecs | |
| name | 否 | String | 巡检项名称,支持模糊搜索 | 云主机 | |
| status | 否 | Boolean | 本参数表示巡检项状态。取值范围: true:启用。 false:停用。 根据以上范围取值。 | true | |
| pageNo | 否 | Integer | 页码,默认1 | 1 | |
| pageSize | 否 | Integer | 每页数量,默认10 | 10 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800为成功,900为失败),默认值:800 | 800 | |
| errorCode | String | 失败时的错误代码,参见公共错误码说明 | ||
| message | String | 失败时的错误描述,一般为英文描述 | Success | |
| msgDesc | String | 失败时的错误描述,一般为中文描述 | 成功 | |
| error | String | 错误码,请求成功时,不返回该字段 | Openapi.Parameter.Error | |
| returnObj | Object | 返回参数 | returnObj |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| strategyList | Array of Objects | 巡检项列表 | strategyObj | |
| totalCount | Integer | 总记录数 | 20 | |
| currentCount | Integer | 当前页记录数 | 5 | |
| totalPage | Integer | 总页数 | 3 |
表 strategyObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| service | String | 云监控服务 | ecs | |
| serviceName | String | 云监控服务名称 | 云主机 | |
| dimension | String | 云监控维度 | ecs | |
| category | String | 本参数表示巡检项类别。取值范围: security:安全。 reliability:可靠。 performance:性能。 cost:成本。 service_limits:服务限制。 根据以上范围取值。 | security | |
| strategyID | String | 巡检项ID | 191db3f4-1d80-aef0-a1c4-4b11386b6890 | |
| strategyKey | String | 巡检项的key | ecs | |
| name | String | 巡检项名称 | 云主机性能评估 | |
| description | String | 巡检项描述 | 云主机磁盘空间耗尽风险 | |
| status | Boolean | 本参数表示巡检项状态。取值范围: true:启用。 false:停用。 根据以上范围取值。 | true | |
| isSupportCustom | Boolean | 本参数表示巡检项是否支持用户调整。取值范围: true:支持。 false:不支持。 根据以上范围取值。 | true |
枚举参数
无
请求示例
请求url
/v4/monitor/cloud-inspection/query-strategies
请求头header
无
请求体body
{
"status": true
}
响应示例
{
"statusCode": 800,
"returnObj": {
"strategyList": [
{
"service": "ippool",
"serviceName": "弹性IP",
"dimension": "fip",
"category": "security",
"strategyID": "191db3f4-1d80-aef0-a1c4-4b11386b6891",
"strategyKey": "eip",
"name": "弹性公网 IP(EIP)闲置",
"description": "检查 EIP 绑定情况,若 EIP 未绑定云资源(CVM 实例、NAT 网关、弹性网卡等),产生额外成本",
"status": true,
"isSupportCustom": true
}
],
"totalCount": 1,
"currentCount": 1,
"totalPage": 1
},
"errorCode": "",
"message": "Success",
"msgDesc": "成功"
}
状态码
请参考 状态码
错误码
请参考 错误码