调用MigrateToOtherZone将Redis实例迁移到同地域内的其它可用区。

该API对应的控制台操作请参见迁移可用区。

说明
  • 如果实例是从经典网络切换到专有网络的，并且保留了经典网络的连接地址，则需等到经典网络连接地址到期释放后才能执行可用区迁移。
  • 迁移之后实例的连接地址不会改变，但VIP会发生变化，请在业务中使用连接地址连接实例而非其VIP地址。

调试

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

请求参数

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

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

DBInstanceId String 是 r-bp1zxszhcgatnx****

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

要迁移到的目标主可用区ID，可调用DescribeZones接口查询。

RegionId String 否 cn-hangzhou

实例所属的地域ID。
VSwitchId String 否 vsw-bp1e7clcw529l773d****

虚拟交换机的ID 。

说明
  • vSwitch所在可用区须与ZoneId（目的可用区）一致；
  • 如果实例的网络类型为VPC，则该参数为必选。
EffectiveTime String 否 Immediately

数据迁移后执行数据库切换的时间，取值：

  • Immediately：迁移完立即切换。
  • MaintainTime：在可维护时间段内切换。
说明 默认值： Immediately。
SecondaryZoneId String 否 cn-hangzhou-h

要迁移到的目标备可用区ID，可调用DescribeZones接口查询。

说明 传入本参数可以实现主备数据节点分布在不同的可用区，实现跨可用区容灾，可承受机房级别的故障。

返回数据

名称 类型 示例值 描述
RequestId String 29B0BF34-D069-4495-92C7-FA6D9452****

请求ID。

示例

请求示例

https://r-kvstore.aliyuncs.com/?Action=MigrateToOtherZone
&DBInstanceId=r-bp1zxszhcgatnx****
&ZoneId=cn-hangzhou-g
&<公共请求参数>

正常返回示例

XML格式 

<MigrateToOtherZoneResponse>
      <RequestId>29B0BF34-D069-4495-92C7-FA6D9452****</RequestId>
</MigrateToOtherZoneResponse>

JSON格式 

{
	"RequestId": "29B0BF34-D069-4495-92C7-FA6D9452****"
}

错误码

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