调用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 |
实例系列,取值:
|
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. | 资源不足,请选择其他可用区。 |
访问错误中心查看更多错误码。