最近更新时间:2024.04.19 11:53:54
首次发布时间:2023.06.30 15:23:34
获取告警联系人组列表。
参数名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListContactGroups | 公共参数,本接口值:ListContactGroups。 |
Version | String | 是 | 2021-03-03 | 公共参数,本接口值:2021-03-03。 |
PageNumber | Integer | 否 | 1 | 当前页数,最小值或默认值均为 1。 |
PageSize | Integer | 否 | 10 | 单页数量:
|
Filter | Object ContactGroupFilter | 否 | - | 联系人组过滤条件。 |
参数名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Ids | Array of String | 否 | ["f9626b5a-0c9e-420e-b6e5-4c66b84f080d"] | 按联系人组 ID 过滤,精确查询。 |
Name | String | 否 | "test" | 按联系人组名称过滤,模糊查询。 |
POST /?Action=ListContactGroups&Version=2021-03-03 Content-Type:application/json { "PageNumber": 1, "PageSize": 10, "Filter": { "Ids": ["f9626b5a-0c9e-420e-b6e5-4c66b84f080d"], "Name": "test" } }
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Total | Integer | 100 | 联系人组总数。 |
Items | Array of ContactGroup | - | 联系人组列表。 |
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Id | String | f9626b5a-0c9e-420e-b6e5-4c66b84f080d | 联系人组 ID。 |
Name | String | test | 联系人组名称。 |
ContactIds | Array of String | ["4a337d5b-0959-4cc7-a3ea-2f71332d4ff3"] | 属于该联系人组的联系人 ID 列表。 |
CreateTime | String | 2020-01-01T00:00:00Z | 联系人组创建时间,RFC3339 格式。 |
HTTP/1.1 200 OK Content-Type:application/json { "ResponseMetadata": { "RequestId": "202211302208xxxx", "Action": "ListContactGroups", "Version": "2021-03-03", "Service": "vmp", "Region": "cn-beijing" }, "Result": { "Total": 100, "Items": [ { "Id": "f9626b5a-0c9e-420e-b6e5-4c66b84f080d", "Name": "test", "ContactIds": ["4a337d5b-0959-4cc7-a3ea-2f71332d4ff3"], "CreateTime": "2020-01-01T00:00:00Z" } ] } }
本接口错误码如下表所示,公共错误码请参见 公共错误码。
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 服务。 |