本文主要介绍PolarDB-X 1.0 API的请求结构,包括服务地址、请求协议和请求方法等。

服务地址

PolarDB-X 1.0 API的服务接入地址请参见下表。

地域(部署位置) 接入地址(Endpoint)
华东1(杭州) drds.cn-hangzhou.aliyuncs.com
华东2(上海) drds.cn-shanghai.aliyuncs.com
华北1(青岛) drds.cn-qingdao.aliyuncs.com
华北2(北京) drds.cn-beijing.aliyuncs.com
华北5(呼和浩特) drds.cn-huhehaote.aliyuncs.com
华南1(深圳) drds.cn-shenzhen.aliyuncs.com
华北3(张家口) drds.cn-zhangjiakou.aliyuncs.com
中国(香港) drds.cn-hongkong.aliyuncs.com
新加坡 drds.ap-southeast-1.aliyuncs.com
美国(弗吉尼亚) drds.us-east-1.aliyuncs.com

通信协议

支持通过HTTP或HTTPS通道进行请求通信。为了获得更高的安全性,推荐您使用HTTPS通道发送请求。

请求方法

支持HTTP GET方法发送请求,这种方式下请求参数需要包含在如下的请求URL中。

http://Endpoint/?Action=xx&Parameters
说明
  • Endpoint:分布式关系型数据库API的服务接入地址,详情情参见服务地址
  • Action:要执行的操作,如调用DescribeTables查询已创建的分布式关系型数据库的数据表。
  • Version:要使用的API版本,当前的API版本是2019-01-23
  • Parameters:请求参数,每个参数之间用英文and符号(&)分隔。

    请求参数由公共请求参数和API自定义参数组成。公共参数中包含API版本号、身份验证等信息,详情请参见公共参数

请求参数

每个请求都需要指定要执行的操作,即Action参数(例如CreateDatabase),以及每个操作都需要包含的公共请求参数和指定操作所特有的请求参数。

字符编码

请求及返回结果都使用UTF-8字符集进行编码。