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

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

调试

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

请求参数

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

系统规定参数。取值：ModifyDBClusterMigration。
DBClusterId String 是 pc-**************

PolarDB集群ID。
SourceRDSDBInstanceId String 是 rm-************

源RDS实例ID。
NewMasterInstanceId String 是 pc-**************

新的实例ID或集群ID，取值范围如下：

  • 切换前，填写PolarDB集群ID进行切换。
  • 切换后，填写RDS实例ID进行回滚。
SwapConnectionString String 否 false

是否需要切换连接地址，取值：

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

默认为false。
ConnectionStrings String 否 {"rm-2ze73el581cs*****.mysql.pre.rds.aliyuncs.com":"pc-2ze8200s298e*****.mysql.polardb.pre.rds.aliyuncs.com","rm-2ze73el581cs86*****.mysql.pre.rds.aliyuncs.com":"test-p*****.mysql.polardb.pre.rds.aliyuncs.com"}

需要切换的具体连接地址。取值为需要两两交换的地址对应的JSON串。

说明 当SwapConnectionString取值为true时生效。

返回数据

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

请求ID。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. 当前的记录中不存在提供的DBClusterId。

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