创建报警策略
更新时间：2026-06-26
创建报警策略
创建云产品报警策略，该接口用于定义报警规则、通知配置和监控目标。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v3/bcm?action=CreateAlarmPolicy HTTP/1.1
2Host: bcm.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "name": "CPU使用率过高报警策略",
7 "scope": "BCE_BCC",
8 "resourceType": "Instance",
9 "target": {...},
10 "rules": [...],
11 "pendingCount": 1,
12 "onMissingData": "SHOW_NO_DATA_AND_NOTIFY",
13 "noDataNotifyPendingMinutes": 10,
14 "type": "CLOUD",
15 "level": "MAJOR",
16 "actions": [{"notifyId": "notify_template_001"}],
17 "notifyEnabled": true
18}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为v3 |
| name | String | 是 | RequestBody参数 | 策略名称 |
| scope | String | 是 | RequestBody参数 | 云产品类型 |
| resourceType | String | 是 | RequestBody参数 | 资源类型 |
| target | AlarmTarget | 是 | RequestBody参数 | 报警目标配置 |
| rules | List<AlarmRule> | 是 | RequestBody参数 | 报警规则列表（OR规则） |
| pendingCount | Integer | 是 | RequestBody参数 | 连续触发阈值，取值范围：大于0 |
| onMissingData | String | 是 | RequestBody参数 | 无数据处理方式，可选值：IGNORE / SHOW_NO_DATA_AND_NOTIFY / SHOW_OK |
| noDataNotifyPendingMinutes | Integer | 否 | RequestBody参数 | 无数据判定间隔，单位：分钟，onMissingData非IGNORE时必填 |
| type | String | 是 | RequestBody参数 | 策略类型，可选值：APP / SITE / CLOUD / CUSTOM |
| level | String | 是 | RequestBody参数 | 报警级别，可选值：NOTICE / WARNING / MAJOR / CRITICAL |
| actions | List<PolicyAction> | 是 | RequestBody参数 | 通知配置列表 |
| notifyEnabled | Boolean | 是 | RequestBody参数 | 是否启用通知 |
| callbacks | List<Callback> | 否 | RequestBody参数 | 回调地址列表 |
| renotifyCount | Integer | 否 | RequestBody参数 | 最大重复报警次数，0表示关闭 |
| renotifyIntervalMinutes | Integer | 否 | RequestBody参数 | 重复通知间隔，单位：分钟，renotifyCount>0时必填 |
| notifyMergeWindowSeconds | Integer | 否 | RequestBody参数 | 通知合并窗口，单位：秒，0表示关闭 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 请求是否成功 |
| code | String | 响应码 |
| message | String | 错误信息 |
| id | String | 策略ID |
请求示例
Plain Text
1POST /v3/bcm?action=CreateAlarmPolicy HTTP/1.1
2HOST bcm.bj.baidubce.com
3Authorization bce-auth-v1/accessKeyId/2024-10-11T10:00:00Z/1800/host/signature
4
5{
6 "name": "CPU使用率过高报警策略",
7 "scope": "BCE_BCC",
8 "resourceType": "Instance",
9 "target": {"type": "TAGS", "tags": [{"key": "environment", "value": "production"}]},
10 "rules": [{"conditions": [{"metricName": "CpuIdlePercent", "metricDimensions": [], "operator": "<", "threshold": 10.0, "aggregateType": "AVG", "windowSeconds": 300, "displayUnit": "%", "displayThreshold": "10"}], "pendingCount": 3, "checkIntervalSeconds": 60}],
11 "pendingCount": 1,
12 "onMissingData": "SHOW_NO_DATA_AND_NOTIFY",
13 "noDataNotifyPendingMinutes": 10,
14 "type": "CLOUD",
15 "level": "MAJOR",
16 "actions": [{"notifyId": "notify_template_001"}],
17 "notifyEnabled": true,
18 "renotifyCount": 5,
19 "renotifyIntervalMinutes": 30,
20 "notifyMergeWindowSeconds": 300
21}响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 8a3b5c7d-1234-5678-abcd-ef0123456789
3Date: Fri, 11 Oct 2024 10:10:30 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7
8{
9 "success": true,
10 "code": "OK",
11 "message": "",
12 "id": "15dfa8a6a43291a5f34a8"
13}评价此篇文章