This topic describes 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. 

https://ecs.aliyuncs.com/?Action=CreateSnapshot
&DiskId=d-28m5zbua0
&<Common request parameters>

  • https indicates the communication protocol.

  • ecs.aliyuncs.com is an ECS service endpoint.

  • Action=CreateSnapshot indicates the target API, and DiskId=d-28m5zbua0 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
Default ecs.aliyuncs.com
China North 3 (Zhangjiakou) ecs.cn-zhangjiakou.aliyuncs.com
China North 5 (Hohhot) ecs.cn-huhehaote.aliyuncs.com
Asia Pacific NE 1 (Tokyo) ecs.ap-northeast-1.aliyuncs.com
Asia Pacific SE 2 (Sydney) ecs.ap-southeast-2.aliyuncs.com
Asia Pacific SE 3 (Kuala Lumpur) ecs.ap-southeast-3.aliyuncs.com
Asia Pacific SE 5 (Jakarta) ecs.ap-southeast-5.aliyuncs.com
Asia Pacific SOU 1 (Mumbai)  ecs.ap-south-1.aliyuncs.com
Middle East 1 (Dubai) ecs.me-east-1.aliyuncs.com
Germany 1 (Frankfurt) ecs.eu-central-1.aliyuncs.com
UK (London) ecs.eu-west-1.aliyuncs.com

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 West 1 Silicon Valley) ecs.us-west-1.aliyuncs.com
Default (US East 1 Virginia) ecs.us-east-1.aliyuncs.com
Default (Hong Kong) ecs.cn-hongkong.aliyuncs.com
Default (Asia Pacific SE 1 Singapore) ecs.ap-southeast-1.aliyuncs.com

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.