文档首页/云搜索服务 CSS/API参考（联盟区域）/API V1/智能运维/创建一次集群检测任务
更新时间：2026-01-12 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建一次集群检测任务

功能介绍

该接口用于创建一个集群检测任务。单集群最多支持创建30个检测任务。

调用方法

请参见如何调用API。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

账户的项目ID。

默认取值：

不涉及

cluster_id

是

String

参数解释：

指定操作的集群ID。获取方法请参见获取集群ID。

约束限制：

不涉及

取值范围：

集群ID。

默认取值：

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Language

否

String

语言

表3 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

检测任务名称。

description

否

String

检测任务描述。

alarm

否

alarm object

检测任务完成后发送SMN告警消息。

表4 alarm

参数

是否必选

参数类型

描述

level

是

String

SMN告警消息敏感度。

  • high：高风险。

  • medium：中风险。

  • suggestion：建议。

  • norisk：无风险。

smn_topic

是

String

SMN主题名称。

响应参数

状态码：200

请求已成功。

无

请求示例

创建一个集群检测任务。

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

{
    "name": " aiops-test ",
"description": "创建集群检测任务。
 ",
    "alarm":{
        "level":"high",
        "smn_topic":"aiops-test"
    }
}

响应示例

无

状态码

状态码

描述

200

请求已成功。

400

非法请求。

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

409

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

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

412

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

错误码

请参见错误码。

父主题：智能运维