调用DescribeContactList接口查询报警联系人列表。

调试

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

请求参数

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

要执行的操作，取值：DescribeContactList。

PageSize Integer 否 10

每页显示的记录条数。

默认值：100。
PageNumber Integer 否 1

当前页码。

默认值：1。
ContactName String 否 Alice

报警联系人姓名。
ChanelType String 否 Mail

报警类型。取值：

  • Mail：邮件。
  • DingWebHook：钉钉机器人。
ChanelValue String 否 Alice@example.com

报警类型的值。

说明 仅当ChanelType设置为Mail时，需要设置该参数。

返回数据

名称 类型 示例值 描述
Code String 200

状态码。

说明 200表示成功。
Message String The Request is not authorization.

错误信息。
RequestId String 06D5ECC2-B9BE-42A4-8FA3-1A610FB08B83

请求ID。
Total Integer 15

总记录条数。
Success Boolean true

操作是否成功。取值：

  • true：成功。
  • false：失败。
Contacts Array of Contact

报警联系方式。
Contact
UpdateTime Long 1552356159000

报警更新时间戳。

单位：毫秒。
Name String Alice

报警联系人姓名。
CreateTime Long 1552356159000

报警创建时间戳。

单位：毫秒。
Lang String zh-cn

报警的语言类型。取值：

  • zh-cn：简体中文。
  • en：英文。
Desc String ECS联系人

描述信息。
ContactGroups Array of String { "ContactGroup": [ "ECS_Group", "Jim" ] }

报警联系人组列表。
Channels Object

报警通知方式。
Mail String Alice@example.com

邮件地址。
AliIM String Alice

旺旺名称。
DingWebHook String https://oapi.dingtalk.com/robot/send?access_token=9bf44f8189597d07dfdd7a123455ffc112****

钉钉机器人地址。
SMS String 1333333****

手机号码。
ChannelsState Object

报警通道的状态。

因为Email需要激活以后才能使用，所以当添加或修改报警通道时，如果处于未激活状态，则为PENDING；如果处于激活状态，则为OK。
Mail String PENDING

Email的状态。取值：

  • PENDING：对应报警通道未激活，激活后才能使用。
  • OK：对应报警通道正常，可正常报警。
AliIM String OK

旺旺名称的状态正常。

目前取值只支持：OK。OK表示旺旺名状态正常，对应的报警通道正常，可正常报警。

说明 该参数仅适用于中国站。
DingWebHook String OK

钉钉机器人的状态正常。

目前取值只支持：OK。OK表示钉钉机器人状态正常，对应的报警通道正常，可正常报警。
SMS String OK

短信的状态。取值：

  • PENDING：对应报警通道未激活，激活后才能使用。
  • OK：对应报警通道正常，可正常报警。
说明 该参数仅适用于中国站。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeContactList
&<公共请求参数>

正常返回示例

XML格式 

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

<DescribeContactListResponse>
		<RequestId>A1267F27-942F-40EE-9254-57FE16E3C9AB</RequestId>
		<Contacts>
			<Contact>
				<Desc>Contact Desc</Desc>
				<ContactGroups>
					<ContactGroup>ECS_Group</ContactGroup>
					<ContactGroup>Jim</ContactGroup>
				</ContactGroups>
				<ChannelsState>
					<SMS>PENDING</SMS>
					<Mail>OK</Mail>
				</ChannelsState>
				<CreateTime>1583307692000</CreateTime>
				<UpdateTime>1589441072000</UpdateTime>
				<Channels>
					<Mail>alice@example.com</Mail>
					<SMS>155*******</SMS>
				</Channels>
				<Name>Alice</Name>
				<Lang>zh-cn</Lang>
			</Contact>
		</Contacts>
		<Total>25</Total>
		<Code>200</Code>
		<Success>true</Success>
</DescribeContactListResponse>

JSON格式 

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

{
  "RequestId" : "A1267F27-942F-40EE-9254-57FE16E3C9AB",
  "Contacts" : {
    "Contact" : [ {
      "Desc" : "Contact Desc",
      "ContactGroups" : {
        "ContactGroup" : [ "ECS_Group", "Jim" ]
      },
      "ChannelsState" : {
        "SMS" : "PENDING",
        "Mail" : "OK"
      },
      "CreateTime" : 1583307692000,
      "UpdateTime" : 1589441072000,
      "Channels" : {
        "Mail" : "alice@example.com",
        "SMS" : "155*******"
      },
      "Name" : "Alice",
      "Lang" : "zh-cn"
    } ]
  },
  "Total" : 25,
  "Code" : "200",
  "Success" : true
}

错误码

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