You can call ECS API operations by sending HTTP or HTTPS GET requests based on URLs. Each URL must contain request parameters. This topic describes the syntax of HTTP or HTTPS GET requests and provides the endpoints of Elastic Compute Service (ECS) API.

Sample request

The following example shows an unencoded URL request to call the CreateSnapshot operation:
&<Common request parameters>
  • https specifies the protocol that is used to transmit the request.
  • specifies the endpoint of ECS.
  • Action=CreateSnapshot specifies the API operation to call. DiskId=d-28m5zbu**** is a request parameter for CreateSnapshot.
  • <Common request parameters> are common parameters defined in the system.


You can send requests over HTTP or HTTPS. For security purposes, we recommend that you send requests over HTTPS.

If requests contain sensitive data such as passwords and SSH key pairs, we recommend that you use HTTPS. For example, if you want to specify the Password parameter when you call the CreateInstance operation, you can send a request over HTTPS to ensure data security.


The following table describes the endpoints of ECS API. To minimize the network latency, we recommend that you specify the endpoint based on the region where you make API requests.

  • IPv4 endpoints
    Region Endpoint
    China (Hangzhou) (Central region)
    Note Global acceleration is enabled for This can reduce the network latency caused by traffic forwarding across countries or regions. You can use this endpoint when you want to make API requests from countries or regions outside the Chinese mainland.
    China (Zhangjiakou)
    China (Hohhot)
    China (Ulanqab)
    China (Heyuan)
    China (Guangzhou)
    Japan (Tokyo)
    Australia (Sydney)
    Malaysia (Kuala Lumpur)
    Indonesia (Jakarta)
    India (Mumbai)
    UAE (Dubai)
    Germany (Frankfurt)
    UK (London)
  • IPv4/IPv6 dual-stack endpoints
    Region Endpoint
    China (Hangzhou) (Central region)
    China (Shanghai) 
    China (Qingdao) 
    China (Beijing)
    China (Zhangjiakou) 
    China (Hohhot) 
    China (Ulanqab) 
    China (Shenzhen)
    China (Heyuan) 
    China (Guangzhou) 
    China (Chengdu) 
    China (Hong Kong) 
Note ECS provides public endpoints. If your ECS instance does not have a public bandwidth or a public IP address, you cannot use tools such as Alibaba Cloud CLI or SDKs to make API requests for the instance. If you want to call API operations on ECS instances in virtual private clouds (VPCs) that cannot access the Internet, you can call the API operations over the internal network. For more information, see Call API operations over the internal network.

Request parameters

You must use the Action parameter to specify the API operation that you want to call. For example, set Action to StartInstance to call the StartInstance operation. You must also specify other operation-specific request parameters and common request parameters. For more information, see Common parameters.


All requests and responses are encoded in UTF-8.