巡检任务：查询单个巡检
更新时间 2026-09-07 16:09:36
最近更新时间: 2026-09-07 16:09:36
接口功能介绍
调用此接口可查询风险实例列表。
接口约束
参见请求参数说明。
URI
POST /v4/monitor/cloud-inspection/query-risk-instances
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| strategyKey | 是 | String | 巡检项的key | cpu | |
| regionIDs | 是 | Array of Strings | 资源池ID列表 | ['81f7728662dd11ec810800155d307d5b'] | |
| projectIDs | 否 | Array of Strings | 企业项目ID列表 | ['0'] | |
| percent | 否 | Integer | 分位值，当方法为分位值时生效，取值范围[1,100]，不传采用默认巡检项默认的分位值 | 95 | |
| Period | 否 | Integer | 巡检周期，不传采用默认巡检项默认的巡检周期 | 7 | |
| Value | 否 | Double | 巡检阈值，不传采用默认巡检项默认的巡检阈值 | 90 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码（800为成功，900为失败），默认值：800 | 800 | |
| errorCode | String | 失败时的错误代码，参见公共错误码说明 | ||
| message | String | 失败时的错误描述，一般为英文描述 | Success | |
| msgDesc | String | 失败时的错误描述，一般为中文描述 | 成功 | |
| error | String | 错误码，请求成功时，不返回该字段 | Openapi.Parameter.Error | |
| returnObj | Object | 返回参数，参考returnObj对象结构 | returnObj |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| riskTotalCount | Integer | 风险实例个数 | 3 | |
| resourceCount | Integer | 巡检资源数 | 3 | |
| risks | Array of Objects | 风险结果列表 | riskDetailObj |
表 riskDetailObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| anomalyID | String | 异常ID | 000f0322-1f4d-8cc8-bb2e-1c30fb751aa5 | |
| anomalyName | String | 异常名称，指标类巡检该值为空 | ecm-1234 | |
| riskLevel | Integer | 本参数表示风险等级。取值范围： 1：低。 2：中。 3：高。 根据以上范围取值。 | 2 |
枚举参数
无
请求示例
请求url
/v4/monitor/cloud-inspection/query-risk-instances
请求头header
无
请求体body
{
"strategyKey":"ecs",
"regionIDs": [
"81f7728662dd11ec810800155d307d5b"
]
}
响应示例
{
"statusCode": 800,
"returnObj": {
"riskTotalCount": 1,
"resourceCount": 10,
"risks": [
{
"anomalyID": "123456",
"anomalyName": "ecm",
"riskLevel": 1
}
]
},
"errorCode": "",
"message": "Success",
"msgDesc": "成功"
}
状态码
请参考 状态码
错误码
请参考 错误码
