API参考 - API参考 -   网络管理 -SwitchDBInstanceNetType

阿里云RDS经典网络实例内外网地址切换指南

功能描述

此接口允许您在阿里云RDS（支持MySQL、SQL Server和PostgreSQL等引擎）的经典网络实例上进行内外网地址的切换。如果实例当前使用内网访问，操作后将变为外网访问；反之亦然。重要提示：切换操作会导致数据库连接地址发生变化，因此需要在应用端相应地更新连接字符串并重启应用以确保服务正常运行。

前提条件

• 实例状态：必须为运行中。
• 切换频率限制：24小时内切换次数不得超过20次。
• 网络类型：仅适用于经典网络实例。
• 实例规格限制：不同实例系列、版本及访问模式对可选的连接地址类型有特定要求，请参照具体规格表配置。

请求参数

• Action: 必填，固定值SwitchDBInstanceNetType，表示执行内外网切换操作。
• DBInstanceId: 必填，指定要切换内外网的实例ID。
• ConnectionStringPrefix: 必填，自定义新的连接前缀，需保证全局唯一性。由小写字母开头，包含字母、数字、中划线，长度8至64个字符。
• Port: 可选，自定义端口号，有效范围为3001至3999，默认为各数据库默认端口（如MySQL默认3306）。
• ConnectionStringType: 可选，指定连接类型，取值为Normal（普通连接）或ReadWriteSplitting（读写分离连接），根据实际需求选择。

返回参数

• NewConnectionString: 切换后的数据库连接地址。
• OldConnectionString: 切换前的数据库连接地址。
• RequestId: 操作请求的唯一标识符。

注意事项

• 连接信息变更：务必在切换后修改应用程序中的数据库连接字符串，并重启应用，以避免服务中断。
• 规格限制：在进行切换前，请确认您的实例规格是否支持所需的内外网地址配置。
• 幂等性保障：通过提供ClientToken参数可以确保请求的幂等性，防止重复操作。

错误处理

操作过程中可能遇到的错误码包括但不限于资源未找到、实名认证未通过、额度不足等，具体错误详情及解决方案请参考阿里云错误中心文档。

通过遵循上述指南，您可以有效地管理和调整RDS实例的网络访问方式，满足不同的业务场景需求。