调用ModifyDBClusterMigration接口切换或回滚RDS一键升级到PolarDB的迁移任务。

  • 在切换前调用该接口会进行切换。
  • 在切换完成后调用该接口会进行回滚。
说明 调用该接口时,集群必须已经创建了一键升级任务。创建一键升级任务的接口为CreateDBCluster,参数CreationOption取值需为MigrationFromRDS。更多信息,请参见一键升级RDS MySQL到PolarDB MySQL

调试

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

请求参数

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

系统规定参数,取值为ModifyDBClusterMigration

DBClusterId String pc-**************

PolarDB集群ID。

NewMasterInstanceId String pc-**************

新的实例ID或集群ID,取值范围如下:

  • 切换前,填写PolarDB集群ID进行切换。
  • 切换后,填写RDS实例ID进行回滚。
SourceRDSDBInstanceId String rm-************

源RDS实例ID。

RegionId String cn-hangzhou

地域ID。

SwapConnectionString String false

是否需要切换连接地址,取值:

  • true:带地址切换(应用程序不用改连接配置)。
  • false:不带地址切换(应用程序需要改为新的PolarDB连接配置)。

默认为false

返回数据

名称 类型 示例值 描述
RequestId String A1B303A5-653F-4AEE-A598-023FF9******

请求ID。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=ModifyDBClusterMigration
&DBClusterId=pc-**************
&NewMasterInstanceId=pc-**************
&SourceRDSDBInstanceId=rm-************
&<公共请求参数>

正常返回示例

XML 格式

<ModifyDBClusterMigrationResponse>  
  <RequestId>A1B303A5-653F-4AEE-A598-023FF9******</RequestId>
</ModifyDBClusterMigrationResponse>

JSON 格式

{
  "RequestId": "A1B303A5-653F-4AEE-A598-023FF9******"
}

错误码

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