Handling Alarms

Function

This API is used to select a contingency plan, script, or job to handle an alarm. You can select an alarm by the alarm ID. You need to specify the contingency plan, script, or job to be executed. For details, see the request parameter description and request example.

URI

POST /v1/alarm-mgmt/alarm/{alarm_id}/auto-process

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
alarm_id	Yes	String	Definition: Alarm ID, which uniquely identifies an alarm. You can obtain the alarm ID from the aggregated alarms page of the alarm management module on COC. Constraints: N/A Value range: N/A Default value: N/A

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
task_type	Yes	Object	Definition Task type. A specific task needs to be executed to handle alarms. For details, see the value range. Constraint scope: N/A Range PLAN: emergency plan. SCRIPT: script. RUNBOOK: indicates a job. Default value: N/A
associated_task_id	Yes	String	Definition: Unique ID of a task. Constraints: N/A Value range: N/A Default value: N/A
associated_task_type	Yes	Object	Definition: Task type. Each task can be classified as a custom task or a public task. Constraints: N/A Value range: CUSTOMIZATION: custom task. COMMUNAL: public task. Default value: N/A
associated_task_name	Yes	String	Definition: Task name. Constraints: N/A Value range: N/A Default value: N/A
associated_task_enterprise_project_id	No	String	Definition: Enterprise project ID. Enterprise ID created by a user on EPS. Constraints: N/A Value range: N/A Default value: N/A
runbook_instance_mode	No	Object	Definition: Job instance mode. Constraints: Select the target instance mode after selecting the job inAlarm Management. Value range: SAME: The steps are the same. DIFF: The steps are independent. MIXED: The steps are customized. Default value: SAME
input_param	Yes	Map<String,String>	Definition: Task execution parameter. Constraints: Select the target instance mode after selecting the job inAlarm Management. Value range: 0–1,000 characters, in JSON format. Default value: N/A
target_instances	No	Array of ScheduleInstance objects	Definition: Target instance information. Constraints: Select the target instance after selecting the job inAlarm Management. Value range: N/A Default value: N/A
region_id	No	String	Definition: Region ID. Constraints: N/A Value range: N/A Default value: N/A
sub_task_info	No	SubTaskInfoDTO object	Description: Subtask information. For details, see related fields in the request body. Constraints: Handle alarms by referring toAlarm Management. Value range: N/A Default value: N/A

**Table 3** ScheduleInstance
Parameter	Mandatory	Type	Description
target_selection	Yes	String	Definition: Target selection mode. Constraints: Select the instance selection mode on the alarm handling page in Alarm Management](tag:hws_hk). Value range: ALL: Select all instances automatically. MANUAL: Select instances manually. NONE: Select no instance. Default value: MANUAL
order_no	Yes	Integer	Definition: Step sequence number. Constraints: Select the job step number (starting from 0) on the alarm handling page in Alarm Management](tag:hws_hk). Value range: N/A Default value: N/A
batch_strategy	No	String	Definition: Batch policy. You can select a batch policy to control the execution scale of instances. Constraints: Select the batch policy on the alarm handling page in Alarm Management](tag:hws_hk). Value range: AUTO_BATCH: automatic batching MANUAL_BATCH: manual batching NONE: no batching Default value: N/A
sub_target_instances	No	Array of ScheduleInstance objects	Description: Substep instance target. You can execute some instances in the substeps of a task. Constraints: The number of substep instance targets cannot exceed 10,000. Value range: N/A Default value: N/A

**Table 4** SubTaskInfoDTO
Parameter	Mandatory	Type	Description
sub_associated_task_id	No	String	Description: Subtask ID, which is the unique identifier of a task. Constraints: The value can contain a maximum of 100 characters. Value range: N/A Default value: N/A
sub_associated_task_name	No	String	Description: Subtask name. Constraints: The value can contain a maximum of 255 characters. Value range: N/A Default value: N/A
sub_associated_task_type	No	Object	Definition Subtask type. Each task can be classified into two types: user-defined task and common task. Constraint scope: N/A Range CUSTOMIZATION: user-defined. COMMUNAL: common. Default value: N/A
sub_task_type	No	Object	Description: Subtask type. Constraints: N/A Value range: SCRIPT: scripts RUNBOOK: jobs PLAN: contingency plans Default value: N/A

Response Parameters

Status code: 200

Response is returned correctly.

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
error_code	String	Error code
error_msg	String	Error description

Example Requests

Use a contingency plan to handle the alarm whose ID is ALM2025071417361705s6mUUrF.

POST https://{Endpoint}/v1/alarm-mgmt/alarm/ALM2025071417361705s6mUUrF/auto-process

{
  "task_type" : "PLAN",
  "associated_task_type" : "CUSTOMIZATION",
  "associated_task_id" : "CTP20250705005804610013656",
  "associated_task_enterprise_project_id" : "0",
  "associated_task_name" : "test-v5",
  "input_param" : {
    "success_rate" : 100,
    "timeout" : 300,
    "execute_user" : "root",
    "project_id" : "****",
    "script_params" : "[{\"paramName\":\"aaa\",\"paramValue\":\"1\",\"paramOrder\":1}]"
  },
  "target_instances" : [ {
    "target_selection" : "MANUAL",
    "target_instances" : "{\"batches\":[{\"batchIndex\":1,\"rotationStrategy\":\"CONTINUE\",\"targetInstances\":[{\"resourceId\":\"****\",\"regionId\":\"cn-north-4\",\"provider\":\"ECS\",\"type\":\"CLOUDSERVERS\",\"agentSn\":\"****\",\"agentStatus\":\"ONLINE\",\"nodeId\":\"\",\"enterpriseProjectId\":\"0\",\"properties\":{\"hostName\":\"platform04-l60076595\",\"fixedIp\":\"192.168.0.50\",\"regionId\":\"cn-north-4\",\"zoneId\":\"cn-north-4a\",\"projectId\":\"****\"}}],\"cmdbInstances\":[{\"id\":\"****\",\"resourceId\":\"****\",\"name\":\"platform04-l60076595\",\"projectId\":\"****\",\"domainId\":\"****\",\"regionId\":\"cn-north-4\",\"agentId\":\"****\",\"agentState\":\"ONLINE\",\"provider\":\"ecs\",\"enterpriseProjectId\":\"0\",\"type\":\"cloudservers\",\"properties\":{\"addresses\":[{\"OsExtIpsType\":\"fixed\",\"OsExtIpsPortId\":\"055f2d75-f3fc-439a-8958-e7bc0b75cb9f\",\"addr\":\"192.168.0.50\",\"version\":4,\"OsExtIpsMacAddr\":\"fa:16:3e:fa:52:84\",\"primary\":true}],\"metadata\":{\"osType\":\"Linux\"},\"OsExtAz\":\"cn-north-4a\",\"status\":\"SHUTOFF\"}}]}],\"policy\":\"none\",\"all_rotation\":\"FIRST_PAUSE\"}",
    "order_no" : 0,
    "batch_strategy" : "NONE"
  } ],
  "runbook_instance_mode" : "SAME",
  "sub_task_info" : {
    "sub_task_type" : "SCRIPT",
    "sub_associated_task_id" : "SC202507042240130195716f7",
    "sub_associated_task_name" : "yy-ccc",
    "sub_associated_task_type" : "CUSTOMIZATION"
  }
}

Use a script to handle the alarm whose ID is ALM2025071417361705s6mUUrF.

POST https://{Endpoint}/v1/alarm-mgmt/alarm/ALM2025071417361705s6mUUrF/auto-process

{
  "task_type" : "SCRIPT",
  "associated_task_type" : "CUSTOMIZATION",
  "associated_task_id" : "SC2025071006154101b779eb7",
  "associated_task_enterprise_project_id" : "0",
  "associated_task_name" : "testScript92DDf",
  "input_param" : {
    "timeout" : 300,
    "execute_user" : "root",
    "success_rate" : 100,
    "project_id" : "****",
    "script_params" : "[]"
  },
  "target_instances" : [ {
    "target_selection" : "MANUAL",
    "target_instances" : "{\"batches\":[{\"batchIndex\":1,\"rotationStrategy\":\"CONTINUE\",\"targetInstances\":[{\"resourceId\":\"****\",\"regionId\":\"cn-north-4\",\"provider\":\"ECS\",\"type\":\"CLOUDSERVERS\",\"agentSn\":\"****\",\"agentStatus\":\"ONLINE\",\"nodeId\":\"\",\"enterpriseProjectId\":\"0\",\"properties\":{\"hostName\":\"platform04-l60076595\",\"fixedIp\":\"192.168.0.50\",\"regionId\":\"cn-north-4\",\"zoneId\":\"cn-north-4a\",\"projectId\":\"****\"}}],\"cmdbInstances\":[{\"id\":\"****\",\"resourceId\":\"****\",\"name\":\"platform04-l60076595\",\"projectId\":\"****\",\"domainId\":\"****\",\"regionId\":\"cn-north-4\",\"agentId\":\"****\",\"agentState\":\"ONLINE\",\"provider\":\"ecs\",\"enterpriseProjectId\":\"0\",\"type\":\"cloudservers\",\"properties\":{\"addresses\":[{\"OsExtIpsType\":\"fixed\",\"OsExtIpsPortId\":\"055f2d75-f3fc-439a-8958-e7bc0b75cb9f\",\"addr\":\"192.168.0.50\",\"version\":4,\"OsExtIpsMacAddr\":\"fa:16:3e:fa:52:84\",\"primary\":true}],\"metadata\":{\"osType\":\"Linux\"},\"OsExtAz\":\"cn-north-4a\",\"status\":\"ACTIVE\"}}]}],\"policy\":\"none\",\"all_rotation\":\"FIRST_PAUSE\"}",
    "order_no" : 0,
    "batch_strategy" : "NONE"
  } ],
  "runbook_instance_mode" : "SAME",
  "sub_task_info" : null
}

Use a job to process the alarm whose ID is ALM2025071417361705s6mUUrF.

POST https://{Endpoint}/v1/alarm-mgmt/alarm/ALM2025071417361705s6mUUrF/auto-process

{
  "task_type" : "RUNBOOK",
  "associated_task_type" : "CUSTOMIZATION",
  "associated_task_id" : "RB2025070814434301497f304",
  "associated_task_enterprise_project_id" : "0",
  "associated_task_name" : "listinstance",
  "input_param" : {
    "success_rate" : 100,
    "project_id" : "****",
    "job_uuid" : "RB2025070814434301497f304",
    "execute_atomic_tasks" : "[{\"accountmgmt_changepwd_task\":false,\"task_name\":\"listinstance\",\"task_name_en\":null,\"task_desc\":null,\"task_desc_en\":null,\"atomic_unique_key\":\"execute_api\",\"type\":\"Simple\",\"sub_tasks\":[{\"accountmgmt_changepwd_task\":false,\"task_name\":\"listinstance\",\"task_name_en\":null,\"task_desc\":null,\"task_desc_en\":null,\"atomic_unique_key\":\"execute_api\",\"type\":\"Simple\",\"sub_tasks\":[],\"inputs\":[{\"param_key\":\"service\",\"param_value\":\"Kafka\",\"value_type\":\"CUSTOM\",\"atomic_name\":null},{\"param_key\":\"apiName\",\"param_value\":\"ListInstances\",\"value_type\":\"CUSTOM\",\"atomic_name\":null},{\"param_key\":\"path\",\"param_value\":{},\"value_type\":\"COMPLEX\",\"atomic_name\":null},{\"param_key\":\"query\",\"param_value\":{\"engine\":\"kafka\",\"name\":null,\"instance_id\":\"****\",\"status\":null,\"include_failure\":null,\"exact_match_name\":null,\"enterprise_project_id\":null,\"offset\":null,\"limit\":null},\"value_type\":\"COMPLEX\",\"atomic_name\":null},{\"param_key\":\"body\",\"param_value\":{},\"value_type\":\"COMPLEX\",\"atomic_name\":null}],\"outputs\":[],\"display_region\":\"REQUIRED\",\"error_handle_type\":\"STOP\",\"execute_batches\":[],\"loop_instances\":[],\"target_instance\":{\"limit\":999,\"required\":false},\"loop_item\":null,\"label\":\"1. listinstance\",\"default_filter_params\":{\"agent_state\":\"ONLINE\"},\"checked_instance\":[]}],\"inputs\":[{\"param_key\":\"service\",\"param_value\":\"Kafka\",\"value_type\":\"CUSTOM\",\"atomic_name\":null},{\"param_key\":\"apiName\",\"param_value\":\"ListInstances\",\"value_type\":\"CUSTOM\",\"atomic_name\":null},{\"param_key\":\"path\",\"param_value\":{},\"value_type\":\"COMPLEX\",\"atomic_name\":null},{\"param_key\":\"query\",\"param_value\":{\"engine\":\"kafka\",\"name\":null,\"instance_id\":\"****\",\"status\":null,\"include_failure\":null,\"exact_match_name\":null,\"enterprise_project_id\":null,\"offset\":null,\"limit\":null},\"value_type\":\"COMPLEX\",\"atomic_name\":null},{\"param_key\":\"body\",\"param_value\":{},\"value_type\":\"COMPLEX\",\"atomic_name\":null}],\"outputs\":[],\"display_region\":\"REQUIRED\",\"error_handle_type\":\"STOP\",\"execute_batches\":[],\"loop_instances\":[],\"target_instance\":{\"limit\":999,\"required\":false},\"loop_item\":null,\"label\":\"1. listinstance\",\"step_same_active\":true,\"step_diff_active\":true}]",
    "vars" : "[]"
  },
  "target_instances" : [ {
    "target_selection" : "NONE",
    "target_instances" : null,
    "order_no" : 0,
    "batch_strategy" : null,
    "sub_target_instances" : [ {
      "target_selection" : "NONE",
      "target_instances" : null,
      "order_no" : 0,
      "batch_strategy" : null
    } ]
  } ],
  "runbook_instance_mode" : "DIFF",
  "sub_task_info" : null,
  "region_id" : "cn-north-4"
}

Example Responses

Status code: 200

Response is returned correctly.

{
  "errorCode" : "200",
  "errorMsg" : "Success",
  "data" : "RBT2025071417373701226d25c"
}

Status Codes

Status Code	Description
200	Response is returned correctly.
400	Invalid request from the client.

Error Codes

See Error Codes.

Parent topic: Alarm Management

Previous topic: Alarm Management

Next topic: Querying Alarm Details

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot