调用UpdateAlertContact接口更新报警联系人。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | 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必须至少填写一个。 说明 如果此参数为空,则表示删除报警联系人的该参数。如果此参数设为一个值,则表示更新报警联系人的该参数。
|
String | 是 | someone@example.com |
将报警联系人的邮箱地址修改为此值。PhoneNum、Email和DingRobotWebhookUrl必须至少填写一个。 说明 如果此参数为空,则表示删除报警联系人的该参数。如果此参数设为一个值,则表示更新报警联系人的该参数。
|
|
PhoneNum | String | 是 | 1381111**** |
将报警联系人的手机号码修改为此值。PhoneNum、Email和DingRobotWebhookUrl必须至少填写一个。 说明 如果此参数为空,则表示删除报警联系人的该参数。如果此参数设为一个值,则表示更新报警联系人的该参数。
|
RegionId | String | 是 | cn-hangzhou |
地域ID。始终填写 |
SystemNoc | Boolean | 是 | true |
是否接收系统通知:
|
ProxyUserId | String | 否 | 123412** |
内部参数。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
IsSuccess | Boolean | true |
更新联系人是否成功:
|
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****"
}
在文档使用中是否遇到以下问题
更多建议
匿名提交