# 告警转事件 - TransferAlarmToIncident #### 功能介绍 告警转为事件。用户可根据告警影响以及执行任务后告警的上报情况，若告警影响严重，则用户可手动选择告警转为事件，按照事件处理流程解决问题。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/COC/doc?api=TransferAlarmToIncident)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-coc/coc_api_06.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | 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。用户选择转事件时，在界面选择应用下拉框选中应用，表示发生事件的应用。 **约束限制：** 请选择[告警管理](https://support.huaweicloud.com/usermanual-coc/coc_um_06_02_04.html)中原始告警中的应用的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事件单。 ``` POST 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 | 正确响应 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-coc/ErrorCode.html)。