调用 CreateAlertContact 创建报警联系人。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateAlertContact

系统规定参数。取值:CreateAlertContact。

ContactName String JohnDoe

报警联系人名称

DingRobotWebhookUrl String https://oapi.dingtalk.com/robot/send?access_token=91f2f6****

钉钉机器人 Webhook URL。获取方式参见 https://ding-doc.dingtalk.com/doc#/serverapi2/qf2nxq 。注意:钉钉机器人安全设置中的自定义关键词请填写“报警”。

Email String someone@example.com

联系人邮箱地址

PhoneNum String 1381111****

联系人手机号码

RegionId String cn-hangzhou

地域 ID。默认请填 cn-hangzhou

SystemNoc Boolean true

是否接收系统通知

ProxyUserId String 12341234

内部参数

邮箱地址、手机号码和钉钉机器人 Webhook URL 这三种联系方式中必须至少填写一种。

返回数据

名称 类型 示例值 描述
RequestId String C21AB7CF-B7AF-410F-BD61-82D1567F65F8

请求 ID

ContactId String 6258

报警联系人 ID

示例

请求示例

http(s)://[Endpoint]/?ContactName=JohnDoe
&DingRobotWebhookUrl=https://oapi.dingtalk.com/robot/send?access_token=xxxxxxx
&Email=johndoe@example.com
&PhoneNum=1381111****
&RegionId=cn-hangzhou
&SystemNoc=true
&<公共请求参数>

正常返回示例

XML 格式

<CreateAlertContact>
      <RequestId>C21AB7CF-B7AF-410F-BD61-82D1567F65F8</RequestId>
      <ContactId>6258</ContactId>
</CreateAlertContact>

JSON 格式

{
    "requestId":"C21AB7CF-B7AF-410F-BD61-82D1567F65F8",
    "contactId":"6258"
}

错误码

访问错误中心查看更多错误码。