调用ModifyDBInstanceNetworkType接口切换RDS实例网络类型。

该接口用于将实例的网络类型从专有网络切换成经典网络,或从经典网络切换成专有网络。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyDBInstanceNetworkType

系统规定参数,取值:ModifyDBInstanceNetworkType

DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。

InstanceNetworkType String Classic

目标网络类型,取值:

  • VPC:专有网络
  • Classic:经典网络
RetainClassic String True

是否保留经典网络地址,取值:

  • True:保留
  • False:不保留

默认值:False

说明 从经典网络切换到专有网络时该参数有效。
ClassicExpiredDays String 7

经典网络地址保留的天数,取值1-120,单位:天。默认值:7

说明 若传入参数 RetainClassic= True,则该参数必传。
ReadWriteSplittingClassicExpiredDays Integer 7

读写分离的经典网络地址保留的天数,取值1-120,单位:天。默认值:7

说明 当实例存在经典网络类型的读写分离地址,且 RetainClassic= True,本参数有效。
VPCId String vpc-uf6f7l4fg90xxxxxx

VPC ID。

VSwitchId String vsw-uf6adz52c2pxxxxx

交换机ID,若传入VPCId,则该参数必传。

PrivateIpAddress String 172.10.40.25

设置实例的内网IP,需要在指定交换机的IP地址范围内。系统默认通过VPCIdVSwitchId自动分配。

ReadWriteSplittingPrivateIpAddress String 192.168.0.22

设置实例的内网读写分离地址的IP,需要在指定交换机的IP地址范围内。系统默认通过VPCIdVSwitchId自动分配。

说明 当前实例存在经典网络类型的读写分离地址时,该值有效。

返回数据

名称 类型 示例值 描述
RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

请求ID。

TaskId String 1025486523574

任务ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=ModifyDBInstanceNetworkType
&DBInstanceId=rm-uf6wjk5xxxxxxx
&InstanceNetworkType=Classic
&<公共请求参数>

正常返回示例

XML 格式

<ModifyDBInstanceNetworkTypeResponse>
	  <RequestId> 65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>
</ModifyDBInstanceNetworkTypeResponse>

JSON 格式

{
  "RequestId": " 65BDA532-28AF-4122-AA39-B382721EEE64"
}

错误码

HttpCode 错误码 错误信息 描述
400 NetTypeExists Specified network type already exists. 网络类型已存在,请检查该参数是否正确。
403 OperationDenied.DBInstanceConnType The current DB instance connection type does not support this operation. 网络连接类型不支持

访问错误中心查看更多错误码。