调用DescibeImportsFromDatabase接口查看实例迁移状态列表。

因为仅MySQL和SQL Server可执行迁移任务,所以仅能查询这两个数据库类型的迁移任务。执行迁移任务请参见ImportDatabaseBetweenInstances

调试

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

请求参数

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

系统规定参数,取值:DescibeImportsFromDatabase

DBInstanceId String rm-bpxxxxx

实例ID。

EndTime String 2011-06-11T16:00Z

查询结束时间。格式:yyyy-MM-ddTHH:mmZ(UTC时间)。

Engine String MySQL

数据库类型。取值:

  • MySQL
  • SQLServer
StartTime String 2011-06-11T15:00Z

查询开始时间。格式:yyyy-MM-ddTHH:mmZ(UTC时间)。

ClientToken String ETnLKlblzczshOTUbOCzxxxxxxx

用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。

ImportId Integer 123

迁移任务的ID。您可以通过接口ImportDatabaseBetweenInstances查询ID。

PageSize Integer 30

每页记录数。取值:

  • 30
  • 50
  • 100

默认值:30

PageNumber Integer 1

页码,取值:大于0且不超过Integer的最大值。

默认值:1

返回数据

名称 类型 示例值 描述
Items Array

迁移状态列表。

ImportResultFromDB
ImportDataStatus String NotStart

迁移任务状态。取值:

  • NotStart:未开始
  • FullExporting:全量导出中
  • FullImporting:全量导入中
  • Success:成功
  • Failed:失败
  • Canceled:已取消
  • Canceling:正在取消
  • IncrementalWaiting:增量同步等待
  • IncrementalImporting:增量同步中
  • StopSyncing:停止同步
ImportDataStatusDescription String 描述信息

迁移任务描述。

ImportDataType String Full

迁移任务类型。取值:

  • Full:全量迁移
  • Incremental:增量迁移
ImportId Integer 123

迁移任务的ID。

IncrementalImportingTime String 2011-06-11T15:00Z

增量同步时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

PageNumber Integer 1

页码。

PageRecordCount Integer 1

每页记录数。

RequestId String B000AA91-393D-46F9-8D9B-098E28931A3A

请求ID。

TotalRecordCount Integer 1

记录总数。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescibeImportsFromDatabase
&DBInstanceId=rm-bpxxxxx
&EndTime=2011-06-11T16:00Z
&Engine=MySQL
&StartTime=2011-06-11T15:00Z
&<公共请求参数>

正常返回示例

XML 格式

<DescibeImportsFromDatabaseResponse>
  <TotalRecordCount>0</TotalRecordCount>
  <PageRecordCount>30</PageRecordCount>
  <RequestId>B000AA91-393D-46F9-8D9B-098E28931A3A</RequestId>
  <PageNumber>1</PageNumber>
  <Items>
        <ImportResultFromDB>
              <ImportId>123</ImportId>
              <ImportDataType>Full</ImportDataType>
              <ImportDataStatus>NotStart</ImportDataStatus>
              <ImportDataStatusDescription>描述信息</ImportDataStatusDescription>
              <IncrementalImportingTime></IncrementalImportingTime>
        </ImportResultFromDB>
  </Items>
</DescibeImportsFromDatabaseResponse>

JSON 格式

{
  "TotalRecordCount": 0,
  "PageRecordCount": 30,
  "RequestId": "B000AA91-393D-46F9-8D9B-098E28931A3A",
  "PageNumber": 1,
  "Items": {
    "ImportResultFromDB": [
      {
        "ImportId":"123",
        "ImportDataType":"Full",
        "ImportDataStatus":"NotStart",
        "ImportDataStatusDescription":"描述信息",
        "IncrementalImportingTime":""
      }
    ]
  }
}

错误码

HttpCode 错误码 错误信息 描述
403 OperationDenied.DBInstanceType The operation is not permitted due to type of instance. 实例类型不支持该操作。只读实例不支持克隆实例。

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