老版查询数据迁移任务的状态。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
|
名称 |
类型 |
是否必选 |
示例值 |
描述 |
| Action | String | 是 | DescribeMigrationJobStatus | 系统规定参数。取值:DescribeMigrationJobStatus。 |
| RegionId | String | 否 | cn-hangzhou | 数据迁移实例所在地域的ID,详情请参见支持的地域列表。 |
| MigrationJobId | String | 是 | dtsxxxxxxxx | 数据迁移实例ID,可以通过调用DescribeMigrationJobs接口查询。 |
| ClientToken | String | 否 | ETnLKlblzczshOTUbOCzxxxxxxxxxx | 保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。 |
| AccountId | String | 否 | 12323344**** | 阿里云主账号ID,无需设置,该参数即将下线。 |
| ResourceGroupId | String | 否 | rg-acfmzawhxxc**** | 资源组ID。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
| RequestId | String | A032E3B4-929B-48E9-97B9-37587CBF**** | 请求ID。 |
| MigrationJobName | String | MySQL迁移 | 数据迁移实例名称。 |
| MigrationJobStatus | String | Migrating | 迁移任务状态,返回值:
|
| ErrCode | String | InternalError | 调用出错时返回的错误码。 |
| Success | String | true | 请求是否成功。 |
| PayType | String | PostPaid | 迁移任务的付费类型,返回值固定为PostPaid(按量付费)。 |
| ErrMessage | String | The request processing has failed due to some unknown error. | 调用错误时返回的错误信息。 |
| MigrationObject | String | [{\"DBName\":\"dtstestdata\",\"TableIncludes\":[{\"TableName\":\"customer\"}]}] | 迁移对象。 |
| MigrationJobId | String | dtsxxxxxxxx | 数据迁移实例ID。 |
| TaskId | String | z2v12jfo309**** | 数据迁移任务ID。 |
| MigrationJobClass | String | 2xlarge | 数据迁移实例的规格,返回值为:small、medium、large、xlarge或2xlarge。更多规格说明,请参见数据迁移链路规格说明。 |
| DataInitializationStatus | Object | 全量数据迁移执行状态。 |
|
| Status | String | Finished | 全量数据迁移状态,取值包括:
|
| Percent | String | 100 | 全量数据迁移进度,单位为百分比。 |
| ErrorMessage | String | java.lang.NumberFormatException: For input string: "" | 全量数据迁移失败的错误提示。 |
| Progress | String | 200001 | 已完成全量数据初始化的记录数。 |
| DataSynchronizationStatus | Object | 增量数据迁移执行状态。 |
|
| Status | String | Catched | 增量数据迁移状态,取值包括:
|
| Percent | String | 95 | 增量数据迁移进度,单位为百分比。 |
| Delay | String | 0 | 增量数据迁移延迟,单位为秒。 |
| ErrorMessage | String | 任务失败太久 无法恢复 | 增量数据迁移失败的错误提示。 |
| Checkpoint | String | 1571040679 | 迁移最新一条增量数据的时间戳,格式为Unix时间戳,单位为秒。 |
| DestinationEndpoint | Object | 目标实例的连接信息。 |
|
| DatabaseName | String | dtstestdata | 目标实例中待迁移对象所属数据库的名称。 |
| InstanceId | String | rm-bpxxxxxxxx | 目标实例ID。 |
| IP | String | 172.16.88.*** | 目标实例的连接地址。 |
| InstanceType | String | RDS | 目标实例类型。 |
| Port | String | 3306 | 目标实例的数据库服务端口。 |
| UserName | String | dtstest | 目标实例的数据库账号。 |
| oracleSID | String | testsid | Oracle数据库的SID信息。 说明 当目标实例的数据库类型为Oracle时,才会返回该参数。 |
| EngineName | String | MySQL | 目标实例的数据库类型。 |
| MigrationMode | Object | 迁移类型。 |
|
| dataInitialization | Boolean | true | 是否迁移全量数据,取值:
|
| dataSynchronization | Boolean | **false**。 | 是否迁移增量数据,取值:
|
| structureInitialization | Boolean | **false**。 | 是否执行结构迁移,取值:
|
| PrecheckStatus | Object | 预检查情况。 |
|
| Status | String | Success | 预检查状态,返回值:
|
| Percent | String | 100 | 预检查整体进度,单位为百分比。 |
| Detail | Array of CheckItem | 各预检查项的检查情况。 |
|
| CheckItem | |||
| CheckStatus | String | Success | 检查结果,返回值:
|
| ErrorMessage | String | Original error: Access denied for user 'dtstest'@'100.104.***.**' (using password: YES) | 预检查未通过的错误提示。 说明 当CheckStatus参数返回值为Failed时,才会返回本参数。 |
| ItemName | String | CHECK_CONN_SRC | 预检查项目。 |
| RepairMethod | String | CHECK_ERROR_DEST_CONN_REPAIR2 | 预检查未通过时对应的修复方法。 说明 当CheckStatus参数返回值为Failed时,才会返回本参数。 |
| SourceEndpoint | Object | 源实例的连接信息。 |
|
| DatabaseName | String | dtstestdatabase | 源实例中待迁移对象所属数据库的名称。 |
| InstanceId | String | rm-bp1i99e8l7913**** | 源实例ID。 |
| IP | String | 172.16.88.*** | 源实例的连接地址。 |
| InstanceType | String | RDS | 源库的实例类型,返回值:
|
| Port | String | 3306 | 源实例的数据库服务端口。 |
| UserName | String | dtstest | 源实例的数据库账号。 |
| oracleSID | String | testsid | Oracle数据库的SID信息。 说明 当迁移的源库的数据库类型为Oracle时,才会返回本参数。 |
| EngineName | String | MySQL | 源实例的数据库类型。 |
| StructureInitializationStatus | Object | 结构迁移执行状态。 |
|
| Status | String | Finished | 结构迁移状态,取值包括:
|
| Percent | String | 100 | 结构迁移进度,单位为百分比。 |
| ErrorMessage | String | DTS-1020042 Execute sql error sql: ERROR: type "geometry" does not exist; | 结构迁移失败的错误提示。 |
| Progress | String | 1 | 已完成结构迁移的表的数量。 |
示例
请求示例
正常返回示例
JSON格式
HTTP/1.1 200 OK
错误码
|
HttpCode |
错误码 |
错误信息 |
描述 |
| 400 | Throttling.User | Request was denied due to user flow control. | 由于请求频次达到阈值,请求被拒绝,请稍后重试。 |
| 403 | InvalidSecurityToken.Expired | Specified SecurityToken is expired. | 签名已经过期,请更新签名 |
| 500 | ServiceUnavailable | The request has failed due to a temporary failure of the server. | 由于服务端响应超时或者不可用导致请求失败,请重试,重试后仍失败请联系技术支持。 |
访问错误中心查看更多错误码。