告警转事件
功能介绍
告警转为事件。用户可根据告警影响以及执行任务后告警的上报情况,若告警影响严重,则用户可手动选择告警转为事件,按照事件处理流程解决问题。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v1/alarm-mgmt/alarms-linked-incident
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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 |
is_service_interrupt |
是 |
Boolean |
参数解释: 业务是否中断。 约束限制: 不涉及 取值范围: 默认取值: false |
level_id |
是 |
String |
参数解释: 事件等级。 约束限制: 不涉及 取值范围: 默认取值: level_50 |
mtm_region |
否 |
String |
参数解释: 区域ID。用户可选择事件发生的区域。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
mtm_type |
是 |
String |
参数解释: 事件类别。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
source_id |
否 |
String |
参数解释: 事件创建方式。用户可根据实际情况,填写事件的创建方式。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
title |
是 |
String |
参数解释: 事件名称。 约束限制: 长度不超过255的字符串 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
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 |
正确响应 |
错误码
请参见错误码。