全部文档
当前文档
最近更新时间：2026-01-29 11:58:46
通过回调接口，您的系统可以直接收到金山云的告警通知。回调接口具备将告警信息通过 HTTP 的 POST 请求推送到可访问公网 URL 的功能，您可基于回调接口推送的告警信息做进一步的处理。
回调接口：用户需要提供能接收 HTTP POST 请求的，公网可访问的 url 地址，作为回调地址。
回调触发：触发逻辑与告警短信、邮件一致，当用户创建的告警策略被触发、告警策略恢复时，均会通过回调接口发送告警消息。
绑定回调接口：用户可在创建告警策略第三步：配置回调接口，一个告警策略组至多可绑定五个告警回调 url。
回调接口通过 HTTP 的 POST 请求发送 JSON 格式的数据，参数如下：
{
"alarmState": 1, // 告警状态，取值：[0: 恢复 | 1: 告警]
"alarmType": "metric", // 告警类型，取值：[metric：阈值告警 | event：事件告警]
"alarmObjInfo": {
"region": "华东1（上海）", // 机房
"regionCode": "cn-shanghai-2", // 机房CODE
"namespace": "EIP", // 产品类型
"tag": [
"host=50fa05d9211b478293744280ac1592ag", // 实例 ID
"hostName=xxxx", // 实例名称
"ipAddr=xxxx", // 实例信息
"p1=cpu1"
]
},
"alarmPolicyInfo": {
"policyId": 8888, // 策略ID
"policyName": "test11", // 策略名称
"conditions": [ // 策略规则
{
"metricAlias": "CPU利用率", // 指标中文名
"metricName": "cpu.util", // 指标英文名
"period": "5m", // 统计周期
"function": "avg", // 统计方式，取值: [max | min | avg | sum]
"points": "1", // 连续统计周期
"op": ">", // 比较操作符:>, <
"threshold": "50", // 阈值
"CurValue": "60", // 当前告警值
"units": "", // 单位
"alarmInterval": "60", // 告警间隔
"alarmMax": "3" // 最大发送告警次数
}
]
},
"timestamp": "1547092067", // 告警时间，从1970年1月1日开始所经过的秒数
"step": 1, // 告警次数
"userId": 2000090561 //账号ID
}{
"alarmState": 1, // 告警状态，取值：[0: 恢复 | 1: 告警]
"alarmType": "event", // 告警类型，取值：[metric：阈值告警 | event：事件告警]
"alarmObjInfo": {
"region": "华东1（上海）", // 机房
"regionCode": "cn-shanghai-2", // 机房 CODE
"namespace": "KEC", // 产品类型
"tag": [
"groupid=1e8375da-b0c3-4678-b7bd-313c561fb4cb", // 事件分组ID
"host=b8709897-1380-441c-a28b-3673350aa25f", // 实例ID
"hostName=test", // 实例名称
"ipAddr=10.0.4.182" // 实例信息
]
},
"alarmPolicyInfo": {
"policyId": 6, // 策略ID
"policyName": "Test_SysEvent_Rule_05", // 策略名称
"conditions": [
{
"historyId": 354616, // 告警id
"eventType": "StatusNotification", // 事件类型
"eventName": "Disk:DiskOperationCompleted", // 事件名称
"eventTitle": "磁盘操作完成", // 事件名称
"eventStatus": "Normal", // 事件状态
"eventLevel": "Info", // 事件等级
"content": "zzzzzMaintenance.PerformanceImpact[xxx] 3" // 事件详情
}
]
},
"timestamp": 1634304898000, // 告警时间，从1970年1月1日开始所经过的毫秒数
"step": 0, // 告警次数
"userId": 73408594 // 账号ID
}纯净模式