# 查询告警消息列表 - ListAlarmNotify
#### 功能介绍
查询单个告警的触发详情与历史。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-apm/apm_04_0007.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-apm/apm_04_0021.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                 | 访问级别 | 资源类型（\*为必须） | 条件键                   | 别名                           | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | apm:application:get | Read | -           | g:EnterpriseProjectId | apm:apm2BusinessBusiness:get | -      |
     
  
 
#### URI
POST /v1/apm2/openapi/alarm/data/get-alarm-notify-list
#### 请求参数
表1请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                |
|:---|:---|:---|:---|
| X-Auth-Token  | 是    | String | 从IAM服务获取的用户Token。 |
| x-business-id | 是    | Long   | 应用id，用于鉴权。        |
   
 表2请求Body参数 
| 参数            | 是否必选 | 参数类型    | 描述          |
|:---|:---|:---|:---|
| page          | 否    | Integer | 页码。         |
| page_size     | 否    | Integer | 每页数量。       |
| alarm_data_id | 是    | Integer | 告警事件id。     |
| region        | 是    | String  | region英文名称。 |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数                         | 参数类型                                                                                         | 描述      |
|:---|:---|:---|
| front_alarm_notify_results | Array of [FrontAlarmNotifyResult] objects | 告警通知列表。 |
| total_count                | Integer                                                                                      | 消息总数。   |
   
 表4FrontAlarmNotifyResult 
| 参数                  | 参数类型    | 描述      |
|:---|:---|:---|
| id                  | Long    | 告警通知id。 |
| gmt_create          | String  | 创建时间。   |
| notify_type         | String  | 通知类型。   |
| alarm_rule_id       | Long    | 告警规则id。 |
| template_id         | Long    | 模板id。   |
| alarm_data_event_id | Long    | 关联事件id。 |
| notify_status       | Boolean | 通知结果。   |
| alarm_content       | String  | 通知内容。   |
   
#### 请求示例
分页查询告警事件ID为42，Region ID为xxx-roma-2的触发详情与历史
```
/v1/apm2/openapi/alarm/data/get-alarm-notify-list
{
  "alarm_data_id" : 42,
  "region" : "xxx-roma-2",
  "page" : 1,
  "page_size" : 10
}
```
#### 响应示例
**状态码： 200**
OK，请求响应成功。
```
{
  "front_alarm_notify_results" : [ {
    "id" : 1741,
    "gmt_create" : "2022-10-09 22:58:27",
    "notify_type" : "RECOVER",
    "alarm_rule_id" : 3,
    "template_id" : 2,
    "alarm_data_event_id" : 42,
    "notify_status" : false,
    "alarm_content" : "CPU0.017使用率为0.017"
  }, {
    "id" : 1735,
    "gmt_create" : "2022-10-09 22:58:26",
    "notify_type" : "RECOVER",
    "alarm_rule_id" : 3,
    "template_id" : 2,
    "alarm_data_event_id" : 42,
    "notify_status" : false,
    "alarm_content" : "CPU0.017使用率为0.017"
  }, {
    "id" : 682,
    "gmt_create" : "2022-10-09 21:20:11",
    "notify_type" : "RECOVER",
    "alarm_rule_id" : 3,
    "template_id" : 2,
    "alarm_data_event_id" : 42,
    "notify_status" : false,
    "alarm_content" : "CPU0.017使用率为0.017"
  }, {
    "id" : 639,
    "gmt_create" : "2022-10-09 21:16:04",
    "notify_type" : "ALARM",
    "alarm_rule_id" : 3,
    "template_id" : 2,
    "alarm_data_event_id" : 42,
    "notify_status" : false,
    "alarm_content" : "CPU0.021使用率为0.021"
  } ],
  "total_count" : 4
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK，请求响应成功。            |
| 400 | Bad Request，语义或参数有误。  |
| 401 | Unauthorized，没有权限。    |
| 403 | Forbidden，禁止访问。       |
| 404 | Not Found，没有找到要请求的资源。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-apm/ErrorCode.html)。