更新通知策略。 ## 请求说明 * 请求方式：POST * 请求地址：https://cloudmonitor.cn\-beijing.volcengineapi.com?Action=UpdateNotification&Version=2018\-01\-01 ## 调试 [去调试](https://api.volcengine.com/api-explorer/debug?action=UpdateNotification&serviceCode=cloudmonitor&version=2018-01-01&groupName=) ## 请求参数 |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |UpdateNotification |接口名称。当前 API 的名称为 `UpdateNotification`。 | |Version |String |是 |2018\-01\-01 |接口版本。当前 API 的版本为 `2018-01-01`。 | |Id |String |否 |189898\*\*\*00 |通知策略 ID。

可以调用 [ListNotifications](https://www.volcengine.com/docs/6408/1527081)接口，获取通知策略 ID。 | |Name |String |否 |notification\-demo |通知策略名称。 | |Notifications |Array of [Notify](https://docs.volcengine.com/docs/6408/1527082#notify) |否 |\- |通知策略详情。 | |EffectStartAt |String |否 |00:00 |通知策略生效的开始时间，格式为`HH:MM`，例如：00:00。 | |EffectEndAt |String |否 |23:59 |通知策略生效的截止时间，格式为`HH:MM`，例如：23:59。

说明

EffectEndAt时间必须晚于EffectStartAt时间。

| ### Notify |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Level |String |否 |notice |告警通知等级，取值：

* **notice**：通知

* **warning**：警告

* **critical**：严重

* **recovery**：恢复 | |WebhookIds |Array of String |否 |18913208\*\*\*4528 |Webhook 回调 ID。

可以调用 [ListWebhooks](https://www.volcengine.com/docs/6408/1283208)接口，获取 Webhook 回调 ID。 | |AlertMethods |Array of String |否 |Email |告警通知方式，取值：

* **Email**：使用邮箱接收告警通知。

* **Phone**：使用电话接收告警通知。

* **SMS**：使用短信接收告警通知。

* **Webhook**：使用 Webhook 接收告警通知。 | |ContactGroupIds |Array of String |否 |145080093687100\*\*\*\* |告警联系组 ID。

可以调用 [ListContactGroups](https://www.volcengine.com/docs/6408/78957)接口，获取联系组 ID。 | |NotifyTemplates |Array of [NotifyTemplateBasic](https://docs.volcengine.com/docs/6408/1527082#notifytemplatebasic) |否 |\- |通知模版配置。 | ### NotifyTemplateBasic |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Channel |String |否 |email |通知渠道，取值：

* **email**：邮箱

* **sms**：短信

* **phone**：电话

* **lark**：飞书

* **dingtalk**：钉钉

* **wecom**：企业微信

* **slack**：Slack

* **api**：回调地址 | |NotifyTemplateId |String |否 |189828\*\*\*00 |通知模版 ID。

注意

每种通知渠道仅支持配置 1 个通知模版 ID。

| ## 请求示例 ```json POST https://cloudmonitor.cn-beijing.volcengineapi.com?Action=UpdateNotification&Version=2018-01-01 Content-Type: application/json { "Id": "189898***00", "Name": "notification-demo", "EffectStartAt": "00:00", "EffectEndAt": "23:59", "Notifications": [ { "Level": "notice", "WebhookIds": [ "18913208***4528" ], "AlertMethods": [ "Email" ], "ContactGroupIds": [ "145080093687100****" ], "NotifyTemplates": [ { "Channel": "email", "NotifyTemplateId": "189828***00" } ] } ] } ``` ## 返回参数 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Data |Array of String |189898\*\*\*00 |通知策略 ID。 | ## 返回示例 ```json { "ResponseMetadata": { "Action": "UpdateNotification", "Region": "cn-beijing", "Service": "cloudmonitor", "Version": "2018-01-01", "RequestId": "20230604110420****100232280022D31" }, "Result": { "Data": [ "189898***00" ] } } ``` ## 错误码本接口无特有的错误码。更多信息请参见 [错误码](https://www.volcengine.com/docs/6408/78947)。

云监控