AllocateReadWriteSplittingConnection
调用AllocateReadWriteSplittingConnection接口申请读写分离地址。
对拥有只读实例的主实例,可以申请读写分离访问地址。申请该地址后,不影响原主实例、只读实例的已有访问地址,以及正常的内外网申请。
调用该接口时,实例必须满足以下条件,否则将操作失败:
- 实例状态为运行中;
- 实例拥有只读实例;
- 实例没有正在执行的迁移任务;
- 实例为如下版本:
- MySQL 5.6
- SQL Server 2017集群版
说明 MySQL 5.7/8.0的实例使用读写分离请参见ModifyDBProxyEndpoint。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | AllocateReadWriteSplittingConnection |
系统规定参数,取值:AllocateReadWriteSplittingConnection。 |
DBInstanceId | String | 是 | rm-uf6wjk5xxxxxxx |
主实例ID。 |
ConnectionStringPrefix | String | 否 | rr-m5exxxxx-rw.mysql.rds.aliyuncs.com |
读写分离地址前缀名,不可重复,由小写字母和中划线组成,需以字母开头,长度不超过30个字符。 说明 默认以“实例名+rw”字符串组成前缀。
|
Port | String | 否 | 3306 |
读写分离端口,取值:
|
MaxDelayTime | String | 否 | 30 |
延迟阈值,范围是0~7200,单位:秒,默认为30。 说明 当只读实例延迟超过该阈值时,读取流量不发往该实例。
|
NetType | String | 否 | Intranet |
读写分离连接串的网络类型,取值:
默认为内网,且内网类型与主实例保持一致。 |
DistributionType | String | 否 | Standard |
读权重分配模式,取值:
|
Weight | String | 否 | {“Instanceid1“:”100”,”Instanceid2”:”200”} |
读权重分配,即传入主实例和只读实例的读请求比例。以100进行递增,最大值为10000,格式:{“Instanceid1“:”Weight”,”Instanceid2”:”Weight”...}。 说明
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 4C467B38-3910-447D-87BC-AC049166F216 |
请求ID 。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=AllocateReadWriteSplittingConnection
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<公共请求参数>
正常返回示例
JSON
格式
{
"RequestId": "4C467B38-3910-447D-87BC-AC049166F216"
}
XML
格式
<AllocateReadWriteSplittingConnectionResponse>
<RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId></AllocateReadWriteSplittingConnectionResponse>
错误码
访问错误中心查看更多错误码。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论