This topic introduces the request structure in GET requests and provides the endpoints of ECS. Alibaba Cloud ECS APIs allow you to initiate GET requests by sending a URL over the HTTP or HTTPS protocol. The request parameters must be included in the URL.

Structure example

The following example is an unencoded URL request of CreateSnapshot.
&<Common request parameters>
  • https indicates the communication protocol.
  • is an ECS service endpoint.
  • Action=CreateSnapshot indicates the target API, and DiskId=d-28m5zbu** is one of the CreateSnapshot parameters.
  • <Common request parameters> are the common parameters of the system.

Communication protocol

Requests over HTTP or HTTPS are supported. We recommend that you send requests over HTTPS for a higher level of security.

If such sensitive information as an SSH key pair or a password exists in your request, we recommend that you choose HTTPS.

Service endpoints

The following table describes the API service access endpoints of ECS. To reduce network latency, we recommend that you configure endpoints based on the source from which you call the service.

Region (Location) Endpoint
China (Hangzhou)
China (Zhangjiakou)
China (Hohhot)
Japan (Tokyo)
Australia (Sydney)
Malaysia (Kuala Lumpur)
Indonesia (Jakarta)
India (Mumbai)
UAE (Dubai)
Germany (Frankfurt)
UK (London)

The endpoints in the following table are accelerated through the virtual network and Express Connect. This reduces network latency that results from communication across different countries or regions.

Region (Location) Endpoint
Default (US Silicon Valley)
Default (US Virginia)
Default (China Hong Kong)
Default (Singapore)
Note The endpoints provided by Alibaba Cloud ECS can be used to send API calls over the Internet through HTTP or HTTPS. However, if your ECS instance is not assigned an Internet bandwidth package or a public IP address, the instance cannot initiate an API action request by using the Alibaba Cloud CLI or corresponding SDK. To resolve this issue, you can use PrivateZone to associate the VPC with the region to which your ECS instance belongs. For information about how to call API actions through an intranet for ECS instances in a VPC that cannot access the Internet, see Call API actions from within an intranet environment.

Request Parameters

You must specify the target operation (for example, Action=StartInstance) by using the Action parameter. Additionally, you must set other API parameters and Common request parameters.

Character encoding

Request parameters and response parameters are encoded by using theUTF-8 character set.