首页 云数据库 RDS 开发参考 API参考 API目录 数据迁移 DescibeImportsFromDatabase - 查看实例迁移状态列表

DescibeImportsFromDatabase - 查看实例迁移状态列表

更新时间: 2023-09-26 17:44:04

该接口用于查看实例迁移状态列表。

接口说明

适用引擎

RDS MySQL

相关功能文档

RDS MySQL实例间数据迁移

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ClientTokenstring

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

ETnLKlblzczshOTUbOCz*******
DBInstanceIdstring

实例ID。可调用DescribeDBInstances获取。

rm-bp*****
Enginestring

数据库类型。取值:MySQL

MySQL
ImportIdinteger

迁移任务的ID。

123
StartTimestring

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

2023-06-11T15:00Z
EndTimestring

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

2023-06-11T16:00Z
PageSizeinteger

每页记录数。取值:

  • 30
  • 50
  • 100

默认值:30

30
PageNumberinteger

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

默认值:1

1
ResourceGroupIdstring

资源组ID。可调用DescribeDBInstanceAttribute获取。

rg-acfmy*****

返回参数

名称类型描述示例值
object

返回参数详情。

RequestIdstring

请求ID。

B000AA91-393D-46F9-8D9B-098E28931A3A
PageNumberinteger

页码。

1
PageRecordCountinteger

每页记录数。

1
TotalRecordCountinteger

记录总数。

1
Itemsobject []

迁移状态列表。

IncrementalImportingTimestring

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

2023-06-11T15:00Z
ImportIdinteger

迁移任务的ID。

123
ImportDataStatusstring

迁移任务状态。取值:

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

迁移任务类型。取值:

  • Full:全量迁移
  • Incremental:增量迁移
Full
ImportDataStatusDescriptionstring

迁移任务描述。

描述信息。

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400InvalidMigrationType.FormatSpecified migration type is not valid.指定的迁移类型无效。
400InvalidPageNumbers.MalformedSpecified page number is not valid.页码数不存在。
400ParameterLeastAssociateMust input at least one optional parameter必须输入至少一个可选参数。
400InvalidParameterCombinationThe end time must be greater than the start time结束时间必须晚于开始时间。
403OperationDenied.DBInstanceTypeThe operation is not permitted due to type of instance.实例类型不支持该操作,请核实是否是主实例。
403InvalidMaxRecordsPerPage.MalformedSpecified record number is not valid.指定的记录号不正确。
404InvalidDBInstanceName.NotFoundInvalid DBInstanceId NotFound.数据库实例ID不存在,请检查。
404InvalidDBInstance.NotFoundSpecified instance does not exist or not support.指定的实例不存在指定的实例被删除或者实例不支持当前操作。

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

变更历史

变更时间变更内容概要操作
2023-07-25OpenAPI 错误码发生变更,OpenAPI 入参发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:403
    删除错误码:404
入参OpenAPI 入参发生变更
    新增入参:ResourceGroupId
阿里云首页 云数据库 RDS 相关技术圈