文档首页/ 云运维中心 COC/ API参考/ API/ 故障管理/ 告警管理/ 告警转事件 - TransferAlarmToIncident
更新时间：2025-10-24 GMT+08:00
查看PDF
分享

告警转事件 - TransferAlarmToIncident

功能介绍

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

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    coc:alarm:createAlarmLinkedIncident

    Write

    -

    -

    -

    -

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" : "演示",
  "attachment" : "[]",
  "assignee" : "****",
  "assignee_scene" : null,
  "assignee_role" : null,
  "source_id" : "incident_source_alarm"
}

响应示例

状态码：200

正确响应

{
  "data" : [ "ALM2025071420081505ylU68fX" ]
}

状态码

状态码

描述

200

正确响应

错误码

请参见错误码。

父主题： 告警管理

相关文档