该接口用于查询POLARDB集群的迁移状态。

该接口用于查询RDS一键迁移到POLARDB的迁移状态。详情请参见一键升级RDS for MySQL到POLARDB for MySQL。

调用该接口时，集群必须已经创建了一键升级任务。创建一键升级任务的接口为CreateDBCluster，参数CreationOption取值需要为MigrationFromRDS。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
DBClusterId String 是 pc-bpxxxxxxx

POLARDB集群ID。
AccessKeyId String 否 key-test

阿里云颁发给用户的访问服务所用的密钥ID。
Action String 否 DescribeDBClusterMigration

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

RegionId String 否 cn-hangzhou

地域ID，如cn-hangzhou。

返回数据

名称 类型 示例值 描述
Comment String xxxxxx

迁移异常的注释信息。
DBClusterId String pc-bpxxxxxxx

POLARDB集群ID。
DBClusterReadWriteMode String ro

POLARDB集群读写模式。

  • rw：读写。
  • ro：只读。
DelayedSeconds Integer 2

RDS与POLARDB之间的复制延迟时间，单位：秒。
ExpiredTime String 2019-07-27T07:31:23Z

RDS与POLARDB之间复制关系到期时间，格式：YYYY-MM-DDThh:mm:ssZ（UTC时间）。

MigrationStatus String RDS2POLARDB_SYNCING

迁移状态，取值：

  • NO_MIGRATION：没有迁移任务。
  • RDS2POLARDB_CLONING：数据克隆中。
  • RDS2POLARDB_SYNCING：数据同步中，此时POLARDB为只读，RDS为可读可写。
  • SWITCHING：数据库切换中。
  • POLARDB2RDS_SYNCING：数据库切换完成，此时POLARDB为可读可写，RDS为只读。您可以修改应用内的连接地址。
  • ROLLBACK：迁移回滚中，回滚完成后，状态变更为RDS2POLARDB_SYNCING。
  • CLOSING_MIGRATION：关闭迁移任务中。
RdsReadWriteMode String rw

源RDS实例读写模式。

  • rw：读写。
  • ro：只读。
RequestId String 05B01253-7CE7-4192-ADBB-795564A90CAC

请求ID。
SourceRDSDBInstanceId String rm-bpxxxxxxx

源RDS实例ID。
Topologies String RDS2POLARDB

同步关系，取值：

  • RDS2POLARDB（从RDS到POLARDB同步）。
  • POLARDB2RDS（从POLARDB到RDS同步）。

示例

请求示例


http(s)://[Endpoint]/?Action=DescribeDBClusterMigration
&DBClusterId=pc-bpxxxxxxx
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeDBClusterMigrationResponse>  
       <Topologies>RDS2POLARDB</Topologies>
      <MigrationStatus>RDS2POLARDB_SYNCING</MigrationStatus>
      <RequestId>05B01253-7CE7-4192-ADBB-795564A90CAC</RequestId>
      <DBClusterId>pc-bpxxxxxxx</DBClusterId>
      <ExpiredTime></ExpiredTime>
      <RdsReadWriteMode>rw</RdsReadWriteMode>
      <DBClusterReadWriteMode>ro</DBClusterReadWriteMode>
      <DelayedSeconds>2</DelayedSeconds>
      <SourceRDSDBInstanceId>rm-bpxxxxxxx</SourceRDSDBInstanceId>
</DescribeDBClusterMigrationResponse>

JSON 格式 

{
	"Topologies":"RDS2POLARDB",
	"MigrationStatus":"RDS2POLARDB_SYNCING",
	"RequestId":"05B01253-7CE7-4192-ADBB-795564A90CAC",
	"DBClusterId":"pc-bpxxxxxxx",
	"ExpiredTime":"",
	"RdsReadWriteMode":"rw",
	"SourceRDSDBInstanceId":"rm-bpxxxxxxx",
	"DelayedSeconds":2,
	"DBClusterReadWriteMode":"ro"
}

错误码

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