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

实例必须是RDS MySQL(本地盘或云盘版)、MariaDB(云盘版)或PostgreSQL(云盘版)。

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

调试

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

请求参数

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

系统规定参数。取值:SwitchDBInstanceVpc

DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。

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

VPC ID。

说明
  • 与RDS实例需属于同一地域。
  • 仅当RDS实例为RDS MySQL本地盘版时,才可以更换VPC。
VSwitchId String vsw-uf6adz52c2pxxxxxxxxxx

交换机ID。

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

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

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

返回数据

名称 类型 示例值 描述
RequestId String 777C4593-8053-427B-99E2-10xxxxxxxxxx

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=SwitchDBInstanceVpc
&DBInstanceId=rm-uf6wjk5xxxxxxx	 
&VPCId=vpc-uf6f7l4fg90xxxxxxxxxx
&VSwitchId=vsw-uf6adz52c2pxxxxxxxxxx
&<公共请求参数>

正常返回示例

XML格式

<RequestId>777C4593-8053-427B-99E2-10xxxxxxxxxx	 </RequestId>

JSON格式

{
    "RequestId": "777C4593-8053-427B-99E2-10xxxxxxxxxx"
}

错误码

HttpCode 错误码 错误信息 描述
400 MigrateAlreadyExistsFault Duplicate migration is forbidden. 禁止重复迁移

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