Request Structure

Last updated: 2019-11-29 18:07:17

PDF

1. Service Address

In this product, your API requests are routed to the nearest server via the domain name cvm.tencentcloudapi.com. You can also access APIs using the domain name for specified region, such as cvm.ap-guangzhou.tencentcloudapi.com for Guangzhou region.

It is recommended to use the domain name for accessing the nearest server. When you call an API, this domain name is automatically resolved to a server in a region nearest to the client where the API is initiated. For example, when you initiate an API request in Guangzhou, this domain name is automatically resolved to a Guangzhou server, with the result same as that of using "cvm.ap-guangzhou.tencentcloudapi.com".

Note: For business sensitive to latency, it is recommended to specify domain names containing the region.

The supported domain names are listed as below:

Region Domain Name
Accessing the nearest server (recommended, and is only for non-Finance regions) cvm.tencentcloudapi.com
South China (Guangzhou) cvm.ap-guangzhou.tencentcloudapi.com
East China (Shanghai) cvm.ap-shanghai.tencentcloudapi.com
North China (Beijing) cvm.ap-beijing.tencentcloudapi.com
Southwest China (Chengdu) cvm.ap-chengdu.tencentcloudapi.com
Southwest China (Chongqing) cvm.ap-chongqing.tencentcloudapi.com
China (Hong Kong) cvm.ap-hongkong.tencentcloudapi.com
Southeast Asia (Singapore) cvm.ap-singapore.tencentcloudapi.com
Asia Pacific (Bangkok) cvm.ap-bangkok.tencentcloudapi.com
Asia Pacific (Mumbai) cvm.ap-mumbai.tencentcloudapi.com
Asia Pacific (Seoul) cvm.ap-seoul.tencentcloudapi.com
Asia Pacific (Tokyo) cvm.ap-tokyo.tencentcloudapi.com
Eastern U.S. (Virginia) cvm.na-ashburn.tencentcloudapi.com
Western U.S. (Silicon Valley) cvm.na-siliconvalley.tencentcloudapi.com
North America (Toronto) cvm.na-toronto.tencentcloudapi.com
Europe (Frankfurt) cvm.eu-frankfurt.tencentcloudapi.com
Europe (Moscow) cvm.eu-moscow.tencentcloudapi.com

Note: Finance regions and non-Finance regions are isolated from each other. Therefore, when you access the services in a finance region (the common parameter Region is finance region), you need to specify a domain name containing the region specified in the Region field.

Finance Region Domain Name
East China (Shanghai Finance) cvm.ap-shanghai-fsi.tencentcloudapi.com
South China (Shenzhen Finance) cvm.ap-shenzhen-fsi.tencentcloudapi.com

2. Communication Protocol

All Tencent Cloud APIs communicate over HTTPS to provide high-security channels.

3. Request Methods

Supported HTTP request method:

  • POST (recommended)
  • GET

Content-Type supported by POST request:

  • application/json (recommended). The TC3-HMAC-SHA256 signature method is required.
  • application/x-www-form-urlencoded. The HmacSHA1 or HmacSHA256 signature methods are required.
  • multipart/form-data (supported only in some APIs). The TC3-HMAC-SHA256 signature method is required.

The length of a GET request cannot exceed 32 KB. The length of a POST request using the HmacSHA1 and HmacSHA256 signature methods cannot exceed 1 MB.

4. Character Encoding

UTF-8 encoding is always used.