This topic describes the request syntax for the DRDS API, including the endpoints, protocols, and request methods.

Endpoints

The following table lists the endpoints for the DRDS API in different regions.

Region Endpoint
China (Hangzhou) drds.cn-hangzhou.aliyuncs.com
China (Shanghai) drds.cn-shanghai.aliyuncs.com
China (Qingdao) drds.cn-qingdao.aliyuncs.com
China (Beijing) drds.cn-beijing.aliyuncs.com
China (Hohhot) drds.cn-huhehaote.aliyuncs.com
China (Shenzhen) drds.cn-shenzhen.aliyuncs.com
China (Zhangjiakou-Beijing Winter Olympics) drds.cn-zhangjiakou.aliyuncs.com
China (Hong Kong) drds.cn-hongkong.aliyuncs.com
Singapore (Singapore) drds.ap-southeast-1.aliyuncs.com
US (Virginia) drds.us-east-1.aliyuncs.com

Protocols

You can send requests over HTTP or HTTPS. We recommend that you use HTTPS for enhanced security.

Methods

You can use the HTTP GET method to send requests. The request parameters must be included in the URL of the request.

http://Endpoint/?Action=xx&Parameters
Note
  • Endpoint: the endpoint of the PolarDB-X API operation. For more information, see Endpoints.
  • Action: the name of the operation being performed. For example, to query tables in a PolarDB-X database, you must set the Action parameter to DescribeTables.
  • Version: the version of the API. Set the value to 2019-01-23.
  • Parameters: the request parameters for the operation. Separate multiple parameters with ampersands (&).

    Request parameters include both common parameters and operation-specific parameters. Common parameters are used for all API calls regardless of the operation. For more information, see Common parameters.

Request parameters

The action to be performed must be specified in the Action parameter of each request. Each operation request must include common request parameters and the specific request parameters of the operation that you call.

Character encoding

All requests and responses are encoded in UTF-8