全部产品
Search
文档中心

云原生数据库 PolarDB:MigrateDBInstance - 实例可用区迁移

更新时间:Sep 10, 2026

该接口用于将实例从一个可用区迁移到另一个可用区。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
RegionIdstring

实例所属地域 ID。

cn-hangzhou
SwitchModestring

切换模式。取值:

  • 0:立即切换。
  • 1:在可运维时间段内切换。
0
DBInstanceNamestring

实例 ID。

pxc-xxx
TopologyTypestring

拓扑类型:

  • 3azones:三可用区;
  • 1azone:单可用区。
3azones
PrimaryZoneIdstring

多可用区实例,主可用区的可用区 ID。如果需要创建多可用区实例,该参数必填。

cn-zhangjiakou-b
SecondaryZoneIdstring

备可用区 ID。

说明 本参数和 ZoneId 属性不能相同。
cn-beijing-l
TertiaryZoneIdstring

第三可用区。

cn-beijing-h
VpcIdstring

访问端点所在的专有网络 ID。

vpc-****
VswitchIdstring

Vswitch ID, 创建 VPC 网络类型的 DRDS 时必须指定

vsw-****

返回参数

名称类型描述示例值
object

MigrateDBInstanceResponse

Successboolean

请求是否成功。

true
Messagestring

成功返回 success,错误返回对应错误码。

*****
RequestIdstring

请求 ID。

FEA5DC20-6D8A-5979-97AA-FC57546ADC20

示例

正常返回示例

JSON格式

{
  "Success": true,
  "Message": "*****",
  "RequestId": "FEA5DC20-6D8A-5979-97AA-FC57546ADC20"
}

错误码

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

变更历史

变更时间变更内容概要操作
2025-10-10新增 OpenAPI查看变更详情