You need to enable JavaScript to run this app.
文档中心
云监控

云监控

请输入
  • 文档首页
    • 云监控API 参考告警联系组ListContactGroups
复制全文
下载 pdf
我的收藏
告警联系组
ListContactGroups
复制全文
下载 pdf
我的收藏
ListContactGroups
获取联系组列表，支持搜索联系组名称的关键字进行模糊查询。​
请求说明​
  • 请求方式：POST​
  • 请求地址：https://cloudmonitor.cn-beijing.volcengineapi.com?Action=ListContactGroups&Version=2018-01-01​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
​
请求参数​
​
参数​
类型​
是否必选​
示例值​
描述​
Action​
String​
是​
ListContactGroups​
接口名称。当前 API 的名称为 ListContactGroups。​
Version​
String​
是​
2018-01-01​
接口版本。当前 API 的版本为 2018-01-01。​
Name​
String​
否​
group​
联系组名称的关键字，支持模糊查询。​
PageSize​
Integer​
否​
20​
分页查询时每页的行数，取值 > 0 ，默认值为 10。​
PageNumber​
Integer​
否​
1​
列表的页码，默认值为 1。要查询的列表范围为：​
  • 实际起始位置 = PageNumber * PageSize​
  • 实际终止位置 = PageNumber * (PageSize + 1)​
​
请求示例​
​
POST https://cloudmonitor.cn-beijing.volcengineapi.com?Action=ListContactGroups&Version=2018-01-01​
Content-Type: application/json​
{​
"Name": "group",​
"PageNumber": 1,​
"PageSize": 20​
}​
​
返回参数​
​
参数​
类型​
示例值​
描述​
Data​
Array of ContactGroupVO​
-​
符合条件的联系组的详细信息。​
PageSize​
Integer​
30​
分页查询参数，用于设置每页行数。默认值为 30。​
PageNumber​
Integer​
1​
分页查询参数，用于设置当前页码。默认值为 1。​
TotalCount​
Integer​
2​
符合条件的联系组总数。​
​
ContactGroupVO​
​
参数​
类型​
示例值​
描述​
Id​
String​
145080093687100****​
联系组 ID。​
Name​
String​
默认告警联系组​
联系组名称。​
AccountId​
String​
100000****​
创建本联系组的账号 ID。​
CreatedAt​
String​
2021-10-20T20:27:53+08:00​
联系组的创建时间。​
UpdatedAt​
String​
2021-10-20T20:27:53+08:00​
联系组的更新时间。​
Description​
String​
This is a group.​
联系组的描述。​
​
返回示例​
​
{​
"ResponseMetadata": {​
"Action": "ListContactGroups",​
"Region": "cn-beijing",​
"Service": "cloudmonitor",​
"Version": "2018-01-01",​
"RequestId": "20230604110420****100232280022D31"​
},​
"Result": {​
"Data": [​
{​
"Id": "145080093687100****",​
"Name": "Default Alert Contact Group",​
"Contacts": [​
{​
"Id": "145262463627244****",​
"Name": "user-demo",​
"Email": "user-demo@example.com",​
"Phone": "1861283****"​
}​
],​
"AccountId": "100000****",​
"CreatedAt": "2021-10-20T20:27:53+08:00",​
"UpdatedAt": "2021-10-20T20:27:53+08:00",​
"Description": "This is a group."​
}​
]​
}​
}​
​
错误码​
本接口无特有的错误码。更多信息请参见 错误码。​
​
​
最近更新时间：2026.08.11 20:28:00
这个页面对您有帮助吗？
有用
有用
无用
无用