SwitchDBInstanceNetType
调用SwitchDBInstanceNetType接口切换内外网地址。
为了节约地址资源,您可以使用该接口进行内外网切换,即原来是内网,则会切换到外网,反之亦然。切换后连接地址会发生变化,需要您修改代码中的连接地址并重启应用。
必须满足以下条件,否则将修改失败:
- 实例只有内网地址和外网地址其中一个;
- 实例状态为运行中;
- 24小时内切换次数低于20次;
- 实例的网络类型为经典网络;
- 实例的设置访问模式和实例规格表对连接地址的选择有如下限制:
- 实例系列为单机基础版,实例版本为MySQL 5.7、SQL Server 2016 web 基础系列、2012 web 基础系列、2012 企业版 基础系列、PostgreSQL 10.0,访问模式为标准模式,连接地址可切换为内网地址、外网地址、内网地址和外网地址;
- 实例系列为双机高可用版,实例版本为MySQL 5.5/5.6/5.7、SQL Server 2008 R2、2016标准版 高可用系列、2012标准版 高可用系列、2016企业版 高可用系列、2012企业版 高可用系列、PostgreSQL 9.4、PPAS 9.3、10.0,访问模式为标准模式,连接地址可切换为内网地址、外网地址;
- 实例系列为双机高可用版,实例版本为MySQL 5.5/5.6/5.7、SQL Server 2008 R2、2016标准版 高可用系列、2012标准版 高可用系列、2016企业版 高可用系列、2012企业版 高可用系列、PostgreSQL 9.4、PPAS 9.3、10.0,访问模式为高安全模式,连接地址可切换为内网地址、外网地址、内网地址和外网地址;
- 实例系列为三节点企业版,实例版本为MySQL 5.6,访问模式为标准模式,连接地址可切换为内网地址、外网地址;
- 实例系列为三节点企业版,实例版本为MySQL 5.6,访问模式为高安全模式,连接地址可切换为内网地址、外网地址、内网地址和外网地址。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | SwitchDBInstanceNetType |
系统规定参数,取值:SwitchDBInstanceNetType。 |
DBInstanceId | String | 是 | rm-uf6wjk5xxxxxxx |
实例ID。 |
ConnectionStringPrefix | String | 是 | test1234 |
自定义连接地址的前辍。由字母,数字组成,小写字母开头,8~64个字符。完整连接地址为:前缀.引擎名.rds.aliyuncs.com。例如test1234.mysql.rds.aliyuncs.com。 |
ClientToken | String | 否 | ETnLKlblzczshOTUbOCzxxxxxx |
用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。 |
Port | String | 否 | 3306 |
端口号,取值:3001~3999。 |
ConnectionStringType | String | 否 | Normal |
连接地址类型,取值:
默认返回所有连接。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 65BDA532-28AF-4122-AA39-B382721EEE64 |
请求ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=SwitchDBInstanceNetType
&DBInstanceId=rm-uf6wjk5xxxxxxx
&ConnectionStringPrefix=rm-xxxxxx
&<公共请求参数>
正常返回示例
JSON
格式
{
"RequestId": " 65BDA532-28AF-4122-AA39-B382721EEE64"
}
XML
格式
<SwitchDBInstanceNetTypeResponse>
<RequestId> 65BDA532-28AF-4122-AA39-B382721EEE64</RequestId></SwitchDBInstanceNetTypeResponse>
错误码
访问错误中心查看更多错误码。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论