告警回调

回调接口可以让您的系统直接收到云平台的告警通知，提供将告警信息通过 HTTP 的 POST 请求推送到用户公网可访问的 url 的功能，用户可基于回调接口推送的告警信息做进一步的处理。

1. 使用方法

   • 回调接口：用户需要提供能接收 HTTP POST 请求的，公网可访问的 url 地址，作为回调地址。

   • 回调触发：触发逻辑与告警短信、邮件一致，当用户创建的告警策略被触发、告警策略恢复时，均会通过回调接口发送告警消息。回调接口也支持重复告警。

   • 绑定接口回调：用户可以在创建告警的“接口回调”步骤配置接口回调，也可在告警策略详情页内添加接口回调。一个告警策略组只可绑定一个告警回调 url。

   • 返回内容：向用户绑定的 url 发出告警信息后，我们需要接收到以下的返回内容，以表明用户已成功接收信息；否则我们将重复发送告警信息，最多发送三次。

     注意：

     sessionId, 用于鉴别回调请求

     retCode，用于判断请求是否发送成功

      {
        sessionId: "xxxxxxxx",
        retCode: 0
      }

2. 回调参数

   回调接口通过 HTTP 的 POST 请求发送 JSON 格式的数据，参数如下：

   {
          "sessionId": "xxxxxxxx",
          "alarmStatus": 1,
          "alarmObjInfo": {
               "region": "gz",  // 不分地域的产品不展示
               "namespace": "qce/cvm",      // 产品的名字空间
               "dimensions": {               // dimensions字段里的内容不同产品有差异
                   "unInstanceId": "ins-o9p3rg3m",  
                   "objId":"xxxxxxxxxxxx",
               }
          }
          "alarmPolicyInfo": {
                   "policyId": "policy-n4exeh88",   // 告警策略组ID
                   "policyType": "cvm_device",     // 告警策略类型
                   "policyName": "test",      // 告警策略组名称
                   "conditions": {
                       "metricName": "cpu usage",         // 指标名称
                       "metricShowName": "CPU 利用率",       // 指标展示名称
                       "calcType": ">",              // 无阈值的指标不展示
                       "calcValue": "90",            // 无阈值的指标不展示
                       "currentValue": "100",       // 无阈值的指标不展示
                       "unit": "%",                 // 无阈值的指标不展示
                       "period": "60",              // 无阈值的指标不展示
                       "periodNum": "1",            // 无阈值的指标不展示
                       "alarmNotifyType": "continuousAlarm",    // 是否支持重复告警,无阈值的指标不展示
                       "alarmNotifyPeriod": 300                 // 重复告警的频率,无阈值的指标不展示
                   }
                   "firstOccurTime": "2017-03-09 07:00:00",     // 第一次触发告警的时间
                   "durationTime": 500,       // 告警持续时间（单位：s）
                   "recoverTime": "0"     // 告警恢复时间（未恢复时为0）
           }
   }