调用UpdateAlertContact接口更新报警联系人。

调试

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

请求参数

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

系统规定参数,取值为UpdateAlertContact

ContactId Long 123

需要更新的报警联系人的ID,可调用SearchAlertContact接口来查询,详情请参见SearchAlertContact

ContactName String John Doe

将报警联系人名称改为此名称。

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

将报警联系人的钉钉机器人Webhook URL修改为此值,获取方式请参见设置钉钉机器人报警。PhoneNum、Email和DingRobotWebhookUrl必须至少填写一个。

说明 如果此参数为空,则表示删除报警联系人的该参数。如果此参数设为一个值,则表示更新报警联系人的该参数。
Email String someone@example.com

将报警联系人的邮箱地址修改为此值。PhoneNum、Email和DingRobotWebhookUrl必须至少填写一个。

说明 如果此参数为空,则表示删除报警联系人的该参数。如果此参数设为一个值,则表示更新报警联系人的该参数。
PhoneNum String 1381111****

将报警联系人的手机号码修改为此值。PhoneNum、Email和DingRobotWebhookUrl必须至少填写一个。

说明 如果此参数为空,则表示删除报警联系人的该参数。如果此参数设为一个值,则表示更新报警联系人的该参数。
RegionId String cn-hangzhou

地域ID。始终填写cn-hangzhou

SystemNoc Boolean true

是否接收系统通知:

  • true:接收系统通知
  • false:不接收系统通知
ProxyUserId String 123412**

内部参数。

返回数据

名称 类型 示例值 描述
IsSuccess Boolean true

更新联系人是否成功:

  • true:更新成功
  • false:更新失败
RequestId String 1A474FF8-7861-4D00-81B5-5BC3DA4E****

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=UpdateAlertContact
&ContactId=123
&ContactName=John Doe
&DingRobotWebhookUrl=https://oapi.dingtalk.com/robot/send?access_token=91f2f6****
&Email=someone@example.com
&PhoneNum=1381111****
&RegionId=cn-hangzhou
&SystemNoc=true
&<公共请求参数>

正常返回示例

XML 格式

<UpdateAlertContactResponse>
	  <IsSuccess>true</IsSuccess>
	  <RequestId>1A474FF8-7861-4D00-81B5-5BC3DA4E****</RequestId>
</UpdateAlertContactResponse>

JSON 格式

{
    "IsSuccess": true,
    "RequestId": "1A474FF8-7861-4D00-81B5-5BC3DA4E****"
}