调用MigrateToOtherZone接口将RDS实例迁移至其他可用区。

例如，实例目前位于华东1（杭州）的cn-hangzhou-a可用区，调用此接口可以将该实例迁移至杭州的cn-hangzhou-b可用区。

说明 仅支持迁移到同一地域的其它可用区，不支持迁移到其它地域的可用区，如华东1（杭州）可用区内的实例不支持迁移至华北1（青岛）的可用区。

调试

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

请求参数

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

系统规定参数，取值：MigrateToOtherZone。

DBInstanceId String 是 rm-uf6wjk5xxxxxxxxxx

实例ID。
ZoneId String 是 cn-hangzhou-b

目标可用区ID，可以通过DescribeRegions接口查看。

VPCId String 否 vpc-xxxxxxx

专有网络VPC ID。迁移可用区时VPC不能变更，需保持不变。

说明 专有网络实例迁移可用区时必须传入该参数。
EffectiveTime String 否 Immediate

生效时间，取值：

默认值：Immediate。

VSwitchId String 否 vsw-uf6adz52c2pxxxxxxx

交换机ID。

说明 专有网络实例迁移可用区时必须传入该参数。
Category String 否 HighAvailability

实例系列，取值：

  • Basic：基础版
  • HighAvailability：高可用版
  • AlwaysOn：集群版
  • Finance：三节点企业版
ZoneIdSlave1 String 否 cn-hangzhou-c

备可用区1。

说明 非基础版实例可传入该参数。
ZoneIdSlave2 String 否 cn-hangzhou-d

备可用区2。

说明 仅三节点企业版实例可传入该参数。

返回数据

名称 类型 示例值 描述
RequestId String 65BDA532-28AF-4122-AA39-B382721EEE64

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=MigrateToOtherZone
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&ZoneId=cn-hangzhou-b
&<公共请求参数>

正常返回示例

XML 格式 

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

JSON 格式 

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

错误码

HttpCode 错误码 错误信息 描述
400 IncorrectDBInstanceLockMode.ValueNotSupported The Current DB instance lock mode does not support this operation. 当前DB实例锁模式不支持此操作。
403 OperationDenied.OutofUsage The resource is out of usage. 资源不足，请选择其他可用区。

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