Updates alert contacts.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes UpdateAlertContact

The operation that you want to perform. Set the value to UpdateAlertContact.

ContactId Long Yes 123

The ID of the alert contact to be updated. You can call the SearchAlertContact operation to query the contact ID. For more information, see SearchAlertContact.

RegionId String Yes cn-hangzhou

The ID of the region. Set the value to cn-hangzhou.

ContactName String No John Doe

The new name of the alert contact.

PhoneNum String No 1381111****

The new mobile phone number of the alert contact. You must specify at least one of the following parameters: PhoneNum, Email, and DingRobotWebhookUrl.

Note If you do not specify this parameter, the original mobile phone number of the alert contact is deleted. If you specify this parameter, the original mobile phone number of the alert contact is updated.
Email String No someone@example.com

The new email address of the alert contact. You must specify at least one of the following parameters: PhoneNum, Email, and DingRobotWebhookUrl.

Note If you do not specify this parameter, the original email address of the alert contact is deleted. If you specify this parameter, the original email address of the alert contact is updated.
DingRobotWebhookUrl String No https://oapi.dingtalk.com/robot/send?access_token=91f2f6****

The new webhook URL of the DingTalk bot. For more information, see Configure a DingTalk chatbot to send alert notifications. You must specify at least one of the following parameters: PhoneNum, Email, and DingRobotWebhookUrl.

Note If you do not specify this parameter, the original webhook URL of the DingTalk bot is deleted. If you specify this parameter, the original webhook URL of the DingTalk bot is updated.
SystemNoc Boolean No true

Specifies whether the alert contact receives system notifications. Valid values:

  • true: receives system notifications.
  • false: does not receive system notifications.

Response parameters

Parameter Type Example Description
IsSuccess Boolean true

Indicates whether the update was successful. Valid values:

  • true: The update was successful.
  • false: The update failed.
RequestId String 1A474FF8-7861-4D00-81B5-5BC3DA4E****

The ID of the request.

Examples

Sample requests

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
&<Common request parameters>

Sample success responses

XML format 

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

JSON format 

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