调用SwitchDBInstanceVpc接口切换RDS实例的专有网络VPC或交换机。

必须是如下实例:

  • RDS MySQL(本地盘或云盘版)
  • RDS SQL Server(云盘版)
  • RDS MariaDB TX(云盘版)
  • RDS PostgreSQL(云盘版)

关于切换的影响,请参见切换VPC或交换机

调试

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

请求参数

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

系统规定参数。取值:SwitchDBInstanceVpc

DBInstanceId String rm-uf6wjk5*****

实例ID。

说明
  • 必须是如下实例:
    • RDS MySQL(本地盘或云盘版)
    • RDS SQL Server(云盘版)
    • RDS MariaDB TX(云盘版)
    • RDS PostgreSQL(云盘版)
  • 实例必须处于运行状态。
  • 实例的网络类型必须是专有网络。
  • 实例不能是临时实例或共享实例。
VPCId String vpc-uf6f7l4fg90*****

VPC ID。

说明 与RDS实例需属于同一地域。
VSwitchId String vsw-uf6adz52c2p*****

交换机ID。

说明 与RDS实例需属于同一可用区。
PrivateIpAddress String 10.23.XX.XX

指定实例的私有IP地址,必须在VSwitchId参数中指定的交换机的网段范围内。

说明 您可以调用DescribeVSwitches查询目标交换机的网段。

返回数据

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

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=SwitchDBInstanceVpc
&DBInstanceId=rm-uf6wjk5*****
&VPCId=vpc-uf6f7l4fg90*****
&VSwitchId=vsw-uf6adz52c2p*****
&PrivateIpAddress=10.23.XX.XX
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SwitchDBInstanceVpcResponse>
    <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
</SwitchDBInstanceVpcResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "1AD222E9-E606-4A42-BF6D-8A4442913CEF"
}

错误码

HttpCode 错误码 错误信息 描述
400 MigrateAlreadyExistsFault Duplicate migration is forbidden. 禁止重复迁移。
400 InvalidConnVPCId Specified conn vpc id is not valid. 指定的连接专有网络ID无效。
400 InvalidInstanceKind.NotSupport The instance kind does not support this operation. 实例类型不支持此操作。
400 InvalidPrivateIpAddress.Mismatch Specified private IP address is not in the CIDR block of virtual switch. VPC地址无效。
400 MigrateAlreadyReadWriteSplitExistsFault The rds instance already has a given vpc migrate task. RDS实例已存在指定VPC迁移任务。

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