文档首页/ 云搜索服务 CSS/ API参考(联盟区域)/ API V1/ 智能运维/ 获取智能运维任务列表及详情
更新时间:2026-01-12 GMT+08:00

获取智能运维任务列表及详情

功能介绍

CSS服务提供智能运维功能,支持检测集群潜在风险。检测任务完成后,可以查看集群存在的风险项详情,根据风险建议及时处理集群存在的风险。此接口用于获取智能运维任务列表及详情。

调用方法

请参见如何调用API

URI

GET /v1.0/{project_id}/clusters/{cluster_id}/ai-ops

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID和名称

约束限制

不涉及

取值范围

账号的项目ID。

默认取值

不涉及

cluster_id

String

参数解释

指定查询的集群ID。获取方法请参见获取集群ID

约束限制

不涉及

取值范围

集群ID。

默认取值

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

limit

Integer

参数解释

分页参数,列表当前分页的数量限制。默认值为10,即一次查询10个任务信息。

约束限制

不涉及

取值范围

1-1000

默认取值

10

offset

Integer

参数解释

偏移量。 偏移量为一个大于0小于终端节点服务总个数的整数,表示从偏移量后面的终端节点服务开始查询。

约束限制

不涉及

取值范围

0-1000

默认取值

0

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

total_size

Integer

参数解释

集群风险检测任务个数。

取值范围

1-1000

aiops_list

Array of aiops_list objects

参数解释

集群风险检测任务详情列表。

取值范围

不涉及

表4 aiops_list

参数

参数类型

描述

id

String

参数解释

集群风险检测任务ID。

取值范围

不涉及

name

String

参数解释

集群风险检测任务名称。

取值范围

不涉及

desc

String

参数解释

集群风险检测任务描述。

取值范围

不涉及

status

Integer

参数解释

任务执行状态。

取值范围

  • 150:未开启。

  • 200:已开启。

  • 300:已发送。

summary

summary object

参数解释

集群风险概要。

取值范围

不涉及

create_time

String

参数解释

集群风险检测任务创建时间。

取值范围

格式:Unix时间戳格式。

smn_status

String

参数解释

集群风险检测任务SMN告警任务发送状态。

取值范围

  • not_open:未开启。

  • not_trigger:未触发。

  • sent:已发送。

  • send_fail: 发送失败。

smn_fail_reason

String

参数解释

集群风险信息会通过SMN发送失败原因。

取值范围

不涉及

task_risks

Array of AIOpsRiskInfo objects

参数解释

集群风险项详情。

取值范围

不涉及

表5 summary

参数

参数类型

描述

high

Integer

参数解释

集群风险检测项判定为高风险的数量。

取值范围

0-100

medium

Integer

参数解释

集群风险检测项判定为中风险的数量。

取值范围

0-100

suggestion

Integer

参数解释

集群风险检测项判定为建议的数量。

取值范围

0-100

表6 AIOpsRiskInfo

参数

参数类型

描述

riskType

String

参数解释

集群风险检测项介绍。

取值范围

不涉及

level

String

参数解释

集群风险等级。

取值范围

  • high:集群高风险。

  • medium:集群中风险。

  • suggestion:集群建议。

desc

String

参数解释

集群风险描述。

取值范围

不涉及

suggestion

String

参数解释

集群风险建议。

取值范围

不涉及

请求示例

获取智能运维任务列表及详情。

GET https://{Endpoint}/v1.0/{project_id}/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/ai-ops

响应示例

状态码:200

请求成功。

{
  "aiops_list" : [ {
    "id" : "7381a80b-68cb-4b9e-8226-37d686b18b1d",
    "name" : "aiops-test",
    "desc" : "",
    "status" : 200,
    "summary" : {
      "high" : 1,
      "medium" : 0,
      "suggestion" : 1
    },
    "create_time" : 1687944156750,
    "smn_status" : "not_open",
    "task_risks" : [ {
      "riskType" : "检测集群7天内是否有快照备份失败,或7天内无快照备份记录。",
      "level" : "suggestion",
      "desc" : "集群7天内无快照备份记录。",
      "suggestion" : "建议您开启集群快照功能并保持7天内快照备份成功。如快照备份失败,建议您进入集群快照页面详细查看失败原因、进入日志管理页面查看日志详情。"
    }, {
      "riskType" : "检测集群节点数与可用区数,判定Elasticsearch分布式集群的高可用性。",
      "level" : "high",
      "desc" : "当前集群为单个或两个节点,当出现一个节点故障时可能导致整个集群不可用,服务可用性风险较高。",
      "suggestion" : "建议您可通过集群控制台-Elasticsearch-更多-形态变更-切换可用区更改为多可用区集群,通过更改集群规格调整集群节点数量。"
    } ]
  } ],
  "total_size" : 1
}

状态码

状态码

描述

200

请求成功。

400

非法请求。

建议直接修改该请求,不要重试该请求。

409

服务器在完成请求时发生冲突。

返回该状态码,表明客户端尝试创建的资源已经存在,或者由于冲突请求的更新操作不能被完成。

412

未满足前提条件,服务器未满足请求者在请求中设置的其中一个前提条件。

错误码

请参见错误码