更新时间:2025-08-04 GMT+08:00
分享

告警转事件

功能介绍

告警转为事件。用户可根据告警影响以及执行任务后告警的上报情况,若告警影响严重,则用户可手动选择告警转为事件,按照事件处理流程解决问题。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v1/alarm-mgmt/alarms-linked-incident

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

alarm_ids

String

参数解释:

告警ID列表,每一条告警ID作为一条告警的唯一标识,可从COC控制台告警管理->汇聚告警获取告警ID。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

enterprise_project_id

String

参数解释:

企业项目ID。由用户在企业项目管理EPS创建的企业ID。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

assignee

String

参数解释:

责任人名称。创建流转规则时,需要指定责任人,可在人员管理模块获取责任人名称。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

assignee_role

String

参数解释:

排班名称。可在基础配置->排班管理获取排班名称。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

assignee_scene

String

参数解释:

排班角色。可在基础配置->排班管理获取排班角色。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

attachment

String

参数解释:

附件列表。用户可在转事件时,上传附件。

约束限制:

不涉及

取值范围:

长度不超过1024的字符串。

默认取值:

不涉及

current_cloud_service_id

String

参数解释:

故障应用ID。用户选择转事件时,在界面选择应用下拉框选中应用,表示发生事件的应用。

约束限制:

请选择告警管理中原始告警中的应用的id。

取值范围:

长度不超过255的字符串。

默认取值:

不涉及

description

String

参数解释:

事件描述。

约束限制:

不涉及

取值范围:

长度不超过600的字符串。

默认取值:

不涉及

is_change_event

Boolean

参数解释:

是否变更事件。

约束限制:

不涉及

取值范围:

  • false:事件不中断。

  • true:事件中断。

默认取值:

false

is_service_interrupt

Boolean

参数解释:

业务是否中断。

约束限制:

不涉及

取值范围:

  • false:业务不中断。

  • true:业务中断。

默认取值:

false

level_id

String

参数解释:

事件等级。

约束限制:

不涉及

取值范围:

  • level_10:P1事件

  • level_20:P2事件

  • level_30:P3事件

  • level_40:P4事件

  • level_50:P5事件

默认取值:

level_50

mtm_region

String

参数解释:

区域ID。用户可选择事件发生的区域。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

mtm_type

String

参数解释:

事件类别。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

source_id

String

参数解释:

事件创建方式。用户可根据实际情况,填写事件的创建方式。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

title

String

参数解释:

事件名称。

约束限制:

长度不超过255的字符串

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

data

Array of strings

参数解释:

清除的告警ID列表。

约束限制:

不涉及

默认取值:

不涉及

请求示例

转换告警ID为‘ALM2025071420081505ylU68fX’的告警为P5事件单。

GET https://{Endpoint}//v1/alarm-mgmt/alarms-linked-incident

{
  "alarm_ids" : "ALM2025071420081505ylU68fX",
  "mtm_region" : "",
  "enterprise_project_id" : "0",
  "current_cloud_service_id" : "****",
  "level_id" : "level_50",
  "is_service_interrupt" : false,
  "mtm_type" : "inc_type_p_monitoring_issues",
  "title" : "test",
  "description" : "演示",
  "owner" : {
    "group_type" : "user",
    "schedule_scene" : null,
    "schedule_role" : null,
    "users" : "****"
  },
  "fault_time" : null,
  "attachment" : "[]",
  "assignee" : "****",
  "assignee_scene" : null,
  "assignee_role" : null,
  "source_id" : "incident_source_alarm"
}

响应示例

状态码:200

正确响应

{
  "data" : [ "ALM2025071420081505ylU68fX" ]
}

状态码

状态码

描述

200

正确响应

错误码

请参见错误码

相关文档