DescribeContactList - CloudMonitor - Alibaba Cloud Documentation Center

Queries alert contacts.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
PageSize	integer	No	The number of entries to return on each page. Default value: 100.	10
PageNumber	integer	No	The number of the page to return. Default value: 1.	1
ContactName	string	No	The name of the alert contact.	Alice
ChanelType	string	No	The alert notification method. Valid values: Mail: emails DingWebHook: DingTalk chatbots	Mail
ChanelValue	string	No	The value specified for the alert notification method. Note This parameter is required only if you set the `ChanelType` parameter to `Mail`.	Alice@example.com

Response parameters

Parameter	Type	Description	Example
	object
Code	string	The HTTP status code. Note The status code 200 indicates that the call was successful.	200
Message	string	The error message.	The Request is not authorization.
RequestId	string	The ID of the request.	06D5ECC2-B9BE-42A4-8FA3-1A610FB08B83
Total	integer	The total number of returned entries.	15
Success	boolean	Indicates whether the call was successful. Valid values: true: The call was successful. false: The call failed.	true
Contacts	object []	The alert contacts.
UpdateTime	long	The timestamp when the alert contact was updated. Unit: milliseconds.	1552356159000
Name	string	The name of the alert contact.	Alice
CreateTime	long	The timestamp when the alert contact was created. Unit: milliseconds.	1552356159000
Lang	string	The language in which the alert information is displayed. Valid values: zh-cn: simplified Chinese en: English	zh-cn
Desc	string	The description of the alert contact.
ContactGroups	array	The alert contact groups.
	string		{ "ContactGroup": [ "ECS_Group", "Jim" ] }
Channels	object	The alert notification method.
Mail	string	The email address of the alert contact.	Alice@example.com
AliIM	string	The TradeManager ID of the alert contact.	Alice
DingWebHook	string	The webhook URL of the DingTalk chatbot.	https://oapi.dingtalk.com/robot/send?access_token=9bf44f8189597d07dfdd7a123455ffc112****
SMS	string	The phone number of the alert contact.	1333333****
ChannelsState	object	The status of the alert notification method. Valid values: PENDING and OK. The email address must be activated after it is added as the value specified for the alert notification method. The value PENDING indicates that the email address is not activated. The value OK indicates that the email address is activated.
Mail	string	The status of the email address. Valid values: PENDING: The email address is not activated. Alert notifications can be sent to the email address only after the email address is activated. OK: The email address is activated and can receive alert notifications.	PENDING
AliIM	string	The status of the TradeManager ID. Valid value: OK. The value OK indicates that the TradeManager ID is valid and can receive alert notifications. Note This parameter can be returned only on the China site (aliyun.com).	OK
DingWebHook	string	The status of the DingTalk chatbot. Valid value: OK. The value OK indicates that the DingTalk chatbot is normal and alert notifications can be received in a DingTalk group.	OK
SMS	string	The status of the phone number. Valid values: PENDING: The phone number is not activated. Alert notifications can be sent to the phone number by using text messages only after the phone number is activated. OK: The phone number is activated and can receive alert notifications. Note This parameter can be returned only on the China site (aliyun.com).	OK

Examples

Sample success responses

JSONformat

{
  "Code": "200",
  "Message": "The Request is not authorization.",
  "RequestId": "06D5ECC2-B9BE-42A4-8FA3-1A610FB08B83",
  "Total": 15,
  "Success": true,
  "Contacts": {
    "Contact": [
      {
        "UpdateTime": 1552356159000,
        "Name": "Alice",
        "CreateTime": 1552356159000,
        "Lang": "zh-cn",
        "Desc": "",
        "ContactGroups": {
          "ContactGroup": [
            "{ \"ContactGroup\": [ \t\"ECS_Group\", \"Jim\" ] }"
          ]
        },
        "Channels": {
          "Mail": "Alice@example.com",
          "AliIM": "Alice",
          "DingWebHook": "https://oapi.dingtalk.com/robot/send?access_token=9bf44f8189597d07dfdd7a123455ffc112****",
          "SMS": "1333333****"
        },
        "ChannelsState": {
          "Mail": "PENDING",
          "AliIM": "OK",
          "DingWebHook": "OK",
          "SMS": "OK"
        }
      }
    ]
  }
}

Error codes

HTTP status code	Error code	Error message
400	InvalidParameter	%s
403	InvalidAuthorization	%s
404	ResourceNotFound	%s
500	InternalError	The request processing has failed due to some unknown error.

For a list of error codes, visit the Service error codes.

Change history

Change time	Summary of changes	Operation

No change history