更新时间：2026-09-03 GMT+08:00

查看智能运维诊断项

功能介绍

CSS服务提供智能运维功能，支持检测集群潜在风险。此接口用于获取智能运维的诊断项。

适用于Elasticsearch和OpenSearch引擎。

调用方法

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID。获取方法请参见获取项目ID和名称。约束限制：不涉及取值范围：账号的项目ID。默认取值：不涉及
cluster_id	是	String	参数解释：指定查询的集群ID。获取方法请参见获取集群ID。约束限制：不涉及取值范围：集群ID。默认取值：不涉及

请求参数

无

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
full_detection	Array of AiOpsDetector objects	参数解释：全量检测项，返回所有可用检测项ID、名称，以及检测描述。
unavailability_detection	Array of AiOpsDetector objects	参数解释：集群不可用检测项，返回所有集群不可用分类的检测项ID、名称，以及检测描述。

表3 AiOpsDetector
参数	参数类型	描述
id	String	参数解释：当前支持的检测项ID。取值范围：不涉及
name	String	参数解释：检测项名称。取值范围：不涉及
desc	String	参数解释：检测项说明。取值范围：不涉及

请求示例

查看智能运维检测项

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

响应示例

状态码：200

智能运维检测项

{
  "full_detection" : [ {
    "id" : "nodeDiskCheck",
    "name" : "Data Node Disk Usage Check",
    "desc" : "Identify data nodes (including cold data nodes) with the highest disk usage in the cluster. Excessive disk usage can affect cluster stability. [N]High risk: When a node's disk usage reaches 85%, no new index replicas will be allocated to it. [N]Medium risk: When a node's disk usage exceeds 80%, take immediate action to prevent further increase."
  } ],
  "unavailability_detection" : [ {
    "id" : "dataNodeDiskBalanceCheck",
    "name" : "Data Node Disk Usage Balance Check",
    "desc" : "Check whether disk usage is balanced across all regular data nodes and cold data nodes. Unbalanced disk usage may cause performance issues. [N]Risk levels: [N]High risk: Maximum disk usage difference between nodes ≥ 40% [N]Medium risk: 25% ≤ Maximum disk usage difference between nodes < 40%."
  } ]
}

状态码

状态码	描述
200	智能运维检测项
400	非法请求。建议直接修改该请求，不要重试该请求。
409	服务器在完成请求时发生冲突。返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。
412	未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。

错误码

请参见错误码。

父主题： 智能运维