SwitchDBInstanceNetType
该接口用于切换经典网络实例的内外网地址
服务地址:
华东1 金融云
输入参数
只看必填
ClientToken用于保证请求的幂等性
DBInstanceId实例ID
ConnectionStringPrefix自定义连接地址的前辍
Port端口号
ConnectionStringType连接地址类型
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

适用引擎

  • RDS MySQL
  • RDS SQL Server

前提条件

  • 实例只有内网地址和外网地址其中一个。
  • 实例状态为运行中。
  • 24 小时内切换次数低于 20 次。
  • 实例的网络类型为经典网络。

注意事项

切换后连接地址会发生变化,需要您修改代码中的连接地址并重启应用。

请求参数

字段名称字段详情
ClientTokenstring

用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过 64 个 ASCII 字符,且该参数值中不能包含非 ASCII 字符。

示例值:ETnLKlblzczshOTUbOCz****
DBInstanceIdstring

实例 ID。可调用 DescribeDBInstances 获取。

示例值:rm-bp1****参考取值来源:
    CloneDBInstance
    CreateDBInstance
    ReceiveDBInstance
    ModifyDBInstanceSpec
    RecoveryDBInstance
    DescribeDBInstances
    CalculateDBInstanceWeight
    MigrateDBNodes
    UpgradeDBInstanceMajorVersion
    TransformDBInstancePayType
    EvaluateLocalExtendDisk
    RestoreDdrTable
    RebuildReplicationLink
ConnectionStringPrefixstring

自定义连接地址的前辍。由字母,数字组成,小写字母开头,8~64 个字符。完整连接地址为:前缀.引擎名.rds.aliyuncs.com。例如 test1234.mysql.rds.aliyuncs.com。

示例值:new****
Portstring

端口号,取值:3001~3999

示例值:3306
ConnectionStringTypestring

连接地址类型,取值:展开详情

示例值:Normal

返回参数

字段名称字段详情
NewConnectionStringstring

切换后的数据库连接地址。

示例值:new****.mysql.rds.aliyuncs.com
OldConnectionStringstring

切换前的数据库连接地址。

示例值:rm-bp1****.mysql.rds.aliyuncs.com
RequestIdstring

请求 ID。

示例值:65BDA532-28AF-4122-AA39-B382721EEE64
变更历史
暂无变更历史