调用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。

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