DescribeContactList - Cloud Monitor - Alibaba Cloud Documentation Center

Queries alert contacts.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

Operation: the value that you can use in the Action element to specify the operation on a resource.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- For mandatory resource types, indicate with a prefix of * .
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition Key: the condition key that is defined by the cloud service.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Operation	Access level	Resource type	Condition key	Associated operation
cms:DescribeContactList	get	All Resources ``	none	none

Request parameters

Parameter	Type	Required	Description	Example
PageSize	integer	No	The number of entries per page. Default value: 100.	10
PageNumber	integer	No	The page number. 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	None.
Code	string	The HTTP status code. Note The status code 200 indicates that the request was successful.	200
Message	string	The error message returned.	The Request is not authorization.
RequestId	string	The request ID.	06D5ECC2-B9BE-42A4-8FA3-1A610FB08B83
Total	integer	The total number of entries returned.	15
Success	boolean	Indicates whether the request was successful. Valid values: true: The request was successful. false: The request failed.	true
Contacts	array<object>	The alert contacts.
Contact	object
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.
ContactGroups	array	None.
ContactGroup	string	The alert contact groups.	{ "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 contac.	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 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.	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 applies only to the Alibaba Cloud 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 applies only to the Alibaba Cloud 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": [
                "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