最近更新时间:2024.04.19 11:53:55
首次发布时间:2023.06.30 15:23:34
获取告警规则列表。
参数名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListAlertingRules | 公共参数,本接口值:ListAlertingRules。 |
Version | String | 是 | 2021-03-03 | 公共参数,本接口值:2021-03-03。 |
PageNumber | Integer | 否 | 1 | 当前页数,最小值或默认值均为 1。 |
PageSize | Integer | 否 | 10 | 单页数量:
|
Filter | Object AlertingRuleFilter | 否 | - | 告警规则过滤条件。 |
参数名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Ids | Array of String | 否 | ["90b5a3da-3464-4718-92e4-039bf41d3cff"] | 按告警规则 ID 过滤,精确查询。 |
Name | String | 否 | test | 按告警规则名称过滤,模糊查询。 |
Type | String | 否 | vmp/PromQL | 按告警规则类型过滤,精确查询。 |
WorkspaceId | String | 否 | e28ae750-bbb8-4ff4-abf4-1e0e0f88808c | 按工作区 ID 过滤,精确查询。 |
NotifyPolicyIds | Array of String | 否 | ["8cd7b480-6387-44e5-aea4-db4ca2c4b47a"] | 按通知策略 ID 过滤,精确查询。 |
NotifyGroupPolicyIds | Array of String | 否 | ["ce4d942a-bac3-4ef6-b3a0-b7845b3b53bf"] | 按聚合策略 ID 过滤,精确查询。 |
Status | String | 否 | Running | 按告警规则状态过滤:
|
POST /?Action=ListAlertingRules&Version=2021-03-03 Content-Type:application/json { "PageNumber": 1, "PageSize": 10, "Filter": { "Ids": ["90b5a3da-3464-4718-92e4-039bf41d3cff"], "Name": "test", "Type": "vmp/PromQL", "WorkspaceId": "e28ae750-bbb8-4ff4-abf4-1e0e0f88808c", "NotifyPolicyIds": ["8cd7b480-6387-44e5-aea4-db4ca2c4b47a"], "NotifyGroupPolicyIds": ["ce4d942a-bac3-4ef6-b3a0-b7845b3b53bf"], "Status": "Running" } }
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Total | Integer | 100 | 告警规则总数。 |
Items | Array of AlertingRule | - | 告警规则列表。 |
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Id | String | 90b5a3da-3464-4718-92e4-039bf41d3cff | 告警规则 ID。 |
CreateTime | String | 2020-01-01T00:00:00Z | 告警规则创建时间。 |
UpdateTime | String | 2020-01-01T00:00:00Z | 告警规则更新时间。 |
Name | String | myRule | 告警规则名称。 |
Description | String | 这是一段描述 | 告警规则描述信息。 |
Type | String | vmp/PromQL | 告警规则类型,固定取值为vmp/PromQL 。 |
Query | Object AlertingRuleQuery | - | 告警配置。 |
Levels | Array of AlertingRuleLevel | - | 告警等级。 |
NotifyPolicyId | String | 8cd7b480-6387-44e5-aea4-db4ca2c4b47a | 告警通知策略 ID。 |
NotifyGroupPolicyId | String | ce4d942a-bac3-4ef6-b3a0-b7845b3b53bf | 告警聚合策略 ID。 |
Status | String | Running | 告警规则状态:
|
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
WorkspaceId | String | e28ae750-bbb8-4ff4-abf4-1e0e0f88808c | 工作区 ID。 |
PromQL | String | sum(up) | 查询语句。 |
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Level | String | P0 | 告警规则等级,包括:P0、P1 和 P2。 |
For | String | 5m | 告警持续时间:
|
Comparator | String | > | 告警规则比较条件:
|
Threshold | Float64 | 1.0 | 告警规则阈值。 |
HTTP/1.1 200 OK Content-Type:application/json { "ResponseMetadata": { "RequestId": "202211302208xxxx", "Action": "ListAlertingRules", "Version": "2021-03-03", "Service": "vmp", "Region": "cn-beijing" }, "Result": { "Total": 100, "Items": [ { "Id": "90b5a3da-3464-4718-92e4-039bf41d3cff", "CreateTime": "2020-01-01T00:00:00Z", "UpdateTime": "2020-01-01T00:00:00Z", "Name": "myRule", "Description": "这是一段描述", "Type": "vmp/PromQL", "Query": { "WorkspaceId": " e28ae750-bbb8-4ff4-abf4-1e0e0f88808c", "PromQL": " sum(up)" }, "Levels": [ { "Level": " P0", "For": " 5m", "Comparator": " >", "Threshold": } ], "NotifyPolicyId": "8cd7b480-6387-44e5-aea4-db4ca2c4b47a", "NotifyGroupPolicyId": "ce4d942a-bac3-4ef6-b3a0-b7845b3b53bf", "Status": "Running" } ] } }
本接口错误码如下表所示,公共错误码请参见 公共错误码。
HTTP 状态码 | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidParameter.{{parameter}} | The specified {{parameter}} is invalid. | 参数不合法,请检查参数正确性后重试。 |
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 服务。 |