创建告警静默策略。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateSilencePolicy | 接口名称。当前 API 的名称为 CreateSilencePolicy 。 |
Version | String | 是 | 2021-03-03 | 接口版本。当前 API 的版本为 2021-03-03 。 |
Name | String | 是 | alert-silence-demo | 告警静默策略名称。
|
Description | String | 否 | 这是一段描述 | 告警静默策略的描述信息。
|
LabelMatchers | Array of String | 是 | - | 使用告警中包含的 Label 匹配需要静默的告警事件。 |
TimeRangeMatchers | Array of TimeRangeMatcher | 是 | - | 告警静默时间。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Date | String | 否 | 2006-01-02 15:04~2006-01-03 14:04 | 告警静默的时间段。用于配置指定时间段内的告警静默。 |
Location | String | 是 | Asia/Shanghai | 时区。 |
PeriodicDate | Object of PeriodicDate | 否 | - | 告警静默的周期。用于配置周期生效的告警静默。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Time | String | 否 | 20:00~21:12 | 时间周期。 |
POST https://open.volcengineapi.com/?Action=CreateSilencePolicy&Version=2021-03-03 Content-Type: application/json { "Name": "alert-silence-demo", "Description": "这是一段描述", "LabelMatchers": [ [ { "Label": "app", "Value": "test", "Operator": "=~" } ] ], "TimeRangeMatchers": [ { "Date": "2006-01-02 15:04~2006-01-03 14:04", "Location": "Asia/Shanghai", "PeriodicDate": { "Time": "20:00~21:12", } } ] }
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Id | String | e28ae750-bbb8-4ff4-abf4-1e0e0f88808c | 告警静默策略 ID。 |
HTTP/1.1: 200 OK Content-Type: application/json { "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "CreateSilencePolicy", "Version": "2021-03-03", "Service": "vmp", "Region": "cn-north-1" }, "Result": { "Id": "e28ae750-bbb8-4ff4-abf4-1e0e0f88808c" } }
本接口错误码如下表所示,公共错误码请参见 公共错误码。
HTTP 状态码 | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | InvalidParameter.{{parameter}} | The specified parameter {{parameter}} is invalid. | 指定的参数无效。 |
400 | MissingParameter.{{parameter}} | The required parameter {{parameter}} is missing. | 缺少必要的参数。 |
403 | ProductUnsubscribed | You are not subscribed to the Volcengine Managed Service for Prometheus (VMP). Please go to the VMP console web page to subscribe to the service | 当前账号未订阅 VMP 服务。 |
409 | Conflict.Name | The specified name conflicts with existing {{resource}}. | 指定的名称与已有资源重复。 |