创建或者修改告警联系人。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ContactId |
integer |
否 |
告警联系人 ID。
|
123 |
| ContactName |
string |
是 |
告警联系人姓名。 |
JohnDoe |
| Phone |
string |
否 |
告警联系人手机号码。 说明
Phone 和 Email 参数至少填写一项。每个手机号码或邮箱只能用于一个联系人。 |
1381111**** |
|
string |
否 |
告警联系人邮箱地址。 说明
Phone 和 Email 参数至少填写一项。每个手机号码或邮箱只能用于一个联系人。 |
someone@example.com |
|
| ReissueSendNotice |
integer |
否 |
电话通知失败后，通知补发类型。
|
3 |
| IsEmailVerify |
boolean |
否 |
邮箱是否已验证 |
true |
| DingRobotUrl |
string |
否 |
钉钉 Webhook 地址。 |
https://oapi.dingtalk.com/robot/send?access_token=69d4e0****** |
| ResourceGroupId |
string |
否 |
资源组 ID。 |
rg-acfmxyexli2**** |
| CorpUserId |
string |
否 |
告警联系人在自己企业组织内的标识，用于三方 IM 的@功能 |
A123221 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID。 |
E9C9DA3D-10FE-472E-9EEF-2D0A3E41**** |
| AlertContact |
object |
返回 AlertContact 对象。 |
|
| ContactId |
number |
告警联系人 ID。 |
123 |
| ContactName |
string |
告警联系人姓名。 |
JohnDoe |
| Phone |
string |
告警联系人手机号码。 |
1381111**** |
|
string |
告警联系人邮箱地址。 |
someone@example.com |
|
| IsVerify |
boolean |
手机号码验证标识。
您可以通过调用 SendTTSVerifyLink 接口验证联系人手机号，仅验证过的手机号可以在通知策略中使用电话的通知方式。 |
false |
| ReissueSendNotice |
integer |
电话通知失败补发类型：0. 不补发 1. 重复拨打一次电话 2. 发送短信通知 3. 使用全局默认值（当前为不补发） |
3 |
| isEmailVerify |
boolean |
邮箱是否已验证。 |
true |
| DingRobotUrl |
string |
钉钉告警机器人 URL。 |
https://test1.com |
示例
正常返回示例
JSON格式
{
"RequestId": "E9C9DA3D-10FE-472E-9EEF-2D0A3E41****",
"AlertContact": {
"ContactId": 123,
"ContactName": "JohnDoe",
"Phone": "1381111****",
"Email": "someone@example.com",
"IsVerify": false,
"ReissueSendNotice": 3,
"isEmailVerify": true,
"DingRobotUrl": "https://test1.com"
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。