SwitchDBInstanceNetType_云数据库 RDS_API文档

插件下载了解更多
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 次。
  • 实例的网络类型为经典网络。

注意事项

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

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
rds:SwitchDBInstanceNetType
Update
DBInstance
acs:rds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

请求参数

字段名称字段详情
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

返回示例

变更历史

暂无变更历史

相关示例

切换内外网地址
2022-06-23