文档中心

云监控

告警联系人

UpdateContactsWithContactGroups

将联系人添加到指定的一个或多个联系组。

使用限制

1 个联系人最多可以添加到 10 个告警联系组。

请求说明

请求方式：POST

请求地址：https://cloudmonitor.cn-beijing.volcengineapi.com?Action=UpdateContactsWithContactGroups&Version=2018-01-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
Action	String	是	UpdateContactsWithContactGroups	接口名称。当前 API 的名称为 UpdateContactsWithContactGroups。
Version	String	是	2018-01-01	接口版本。当前 API 的版本为 2018-01-01。
Id	String	是	145262463627244****	联系人 ID。可以调用 ListContacts 接口，获取联系人 ID。
ContactGroupIds	Array of String	是	["145080093687100**","145080093687100**"]	联系组 ID。取值会替换联系人已关联的联系组。联系组 ID 不能超过 10 条，即单个联系人最多可以添加到 10 个联系组中。可以调用 ListContactGroups 接口，获取联系组 ID。

请求示例

POST https://cloudmonitor.cn-beijing.volcengineapi.com?Action=UpdateContactsWithContactGroups&Version=2018-01-01​
Content-Type: application/json​
{​
    "Id": "145262463627244****",​
    "ContactGroupIds": [​
        "145080093687100****",​
        "145080093687100****"​
    ]​
}​

返回参数

参数	类型	示例值	描述
Data	Array of String	["145262463627244****"]	联系人 ID。

返回示例

{​
    "ResponseMetadata": {​
        "Action": "UpdateContactsWithContactGroups",​
        "Region": "cn-beijing",​
        "Service": "cloudmonitor",​
        "Version": "2018-01-01",​
        "RequestId": "20230604110420****100232280022D31"​
    },​
    "Result": {​
        "Data": [​
            "145262463627244****"​
        ]​
    }​
}​

错误码

本接口无特有的错误码。更多信息请参见错误码。

最近更新时间：2026.08.11 20:28:00

这个页面对您有帮助吗？

有用

无用