To send a Cloud Monitor API request, you must send an HTTP GET request to the Cloud Monitor endpoint. You must add the request parameters that correspond to the API operation being called. After you call the API operation, the system returns a response. The request and response are encoded in UTF-8.

Request syntax

Cloud Monitor API operations use the RPC protocol. You can call Cloud Monitor API operations by sending HTTP GET requests.

The following request syntax is used:


  • Endpoint: the endpoint of the Cloud Monitor API is For more information about the endpoints of various regions, see Cloud Monitor endpoints.
  • Action: the operation that you want to perform. For example, to query the monitoring data of an instance, you set the Action parameter to DescribeMetricList.
  • Version: the version number of the API. The version number of the Cloud Monitor API is 2019-01-01.
  • Parameters: the request parameters for the operation. Separate multiple parameters with ampersands (&). Request parameters include both common parameters and operation-specific parameters. Common parameters include information such as the API version number and authentication information.
The following example demonstrates how to call the DescribeMetricList operation in Cloud Monitor:
&EndTime=2020-06-01 00:00:00
&StartTime=2020-06-30 00:00:00
&Dimensions={"instanceId": "i-uf6hm9lnlzsarrc7****"}

Cloud Monitor endpoints

Region Endpoint
China (Qingdao)
China (Beijing)
China (Zhangjiakou-Beijing Winter Olympics)
China (Hohhot)
China (Hangzhou)
China (Shanghai)
China (Shenzhen)
China (Hong Kong)
Singapore (Singapore)
Australia (Sydney)
Malaysia (Kuala Lumpur)
Indonesia (Jakarta)
India (Mumbai)
Japan (Tokyo)
US (Silicon Valley)
US (Virginia)
Germany (Frankfurt)
UK (London)
UAE (Dubai)

API authorization

To ensure the security of your account, we recommend that you call Cloud Monitor API operations as a Resource Access Management (RAM) user. If you call Cloud Monitor API operations as a RAM user , you must create permission policies for or grant permission policies to the RAM user .

Signature method

To ensure secure calls to the API, Alibaba Cloud authenticates each API request by using the signature. When you manually make an API request, you must use the AccessKey secret to calculate the hash-based message authentication code (HMAC) value based on the encoded and sorted request string in accordance with the definition in RFC 2104. The HMAC value is the signature. For more information, see Does CloudMonitor support the HMAC-SHA1 signature algorithm and how do I use it?.

You must add the signature to the Cloud Monitor API request in the following format:


Take DescribeMetricList as an example. If the AccessKey ID is testid and the AccessKey secret is testsecret, the following URL is the original request URL:{instanceId:'i-abcdefgh12****'}&Timestamp=2017-03-23T06:59:55Z&Namespace=acs_ecs_dashboard&SignatureVersion=1.0&Format=JSON&SignatureNonce=aeb03861-611f-43c6-9c07-b752fad3****&Version=2015-10-20&AccessKeyId=TestId&MetricName=cpu_idle&SignatureMethod=HMAC-SHA1
The following string is the string to sign:
The AccessKey secret is testsecret, so the key for the HMAC calculation is testsecret&. The following string is the calculated signature string:

Add the signature string as the Signature parameter to the request URL. The following URL is the signed request URL:****%3D