调用CreateOrUpdateContact接口创建或者修改告警联系人。

调试

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

请求参数

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

系统规定参数。取值:CreateOrUpdateContact

ContactId Long 123

告警联系人ID。

  • 不填代表创建新的告警联系人。
  • 填写代表修改指定告警联系人信息。
ContactName String JohnDoe

告警联系人姓名。

Phone String 1381111****

告警联系人手机号码。

说明 PhoneEmail参数至少填写一项。每个手机号码或邮箱只能用于一个联系人。
Email String someone@example.com

告警联系人邮箱地址。

说明 PhoneEmail参数至少填写一项。每个手机号码或邮箱只能用于一个联系人。

返回数据

名称 类型 示例值 描述
RequestId String E9C9DA3D-10FE-472E-9EEF-2D0A3E41****

请求ID。

AlertContact Object

返回AlertContact对象。

ContactId Float 123

告警联系人ID。

ContactName String JohnDoe

告警联系人姓名。

Phone String 1381111****

告警联系人手机号码。

Email String someone@example.com

告警联系人邮箱地址。

IsVerify Boolean false

手机号码验证标识。

  • fasle(默认):未验证。
  • true:已验证。

您可以通过调用SendTTSVerifyLink接口验证联系人手机号,仅验证过的手机号可以在通知策略中使用电话的通知方式。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateOrUpdateContact
&ContactId=123
&ContactName=JohnDoe
&Phone=1381111****
&Email=someone@example.com
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateOrUpdateContactResponse>
    <RequestId>E9C9DA3D-10FE-472E-9EEF-2D0A3E41****</RequestId>
    <AlertContact>
        <ContactId>123</ContactId>
        <ContactName>JohnDoe</ContactName>
        <Phone>1381111****</Phone>
        <Email>someone@example.com</Email>
        <IsVerify>false</IsVerify>
    </AlertContact>
</CreateOrUpdateContactResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "E9C9DA3D-10FE-472E-9EEF-2D0A3E41****",
  "AlertContact" : {
    "ContactId" : 123,
    "ContactName" : "JohnDoe",
    "Phone" : "1381111****",
    "Email" : "someone@example.com",
    "IsVerify" : false
  }
}