All Products
Search
Document Center

DataWorks:GetMigrationSummary

Last Updated:Oct 17, 2024

Queries the information about a migration task.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
ProjectIdlongYes

The DataWorks workspace ID. You can log on to the DataWorks console and go to the Workspace page to obtain the workspace ID.

12345
MigrationIdlongYes

The migration task ID.

You can call the CreateImportMigration operation to obtain the ID of the import task and call the CreateExportMigration operation to obtain the ID of the export task.

1234

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The request ID. You can use the request ID to query logs and troubleshoot issues.

19999A96-71BA-2845-B455-ED620EF4E37F
Successboolean

Indicates whether the request was successful. Valid values:

  • true
  • false
true
Dataobject

The details of the migration task.

MigrationIdlong

The task ID.

1234
Namestring

The task name.

test_export_01
GmtCreatelong

The time when the task was created.

1589904000000
GmtModifiedlong

The time when the task was modified.

1589904000000
CreateUserstring

The ID of the user who created the task.

982293332403****
OpUserstring

The ID of the user who managed the task.

982293332403****
Statusstring

The status of the migration task. Valid values:

  • INIT
  • EDITING
  • IMPORTING
  • IMPORT_ERROR
  • IMPORT_SUCCESS
  • EXPORTING
  • EXPORT_ERROR
  • EXPORT_SUCCESS
  • REVOKED
  • PARTIAL_SUCCESS
EXPORT_SUCCESS
ProjectIdlong

The ID of the DataWorks workspace to which the migration task belongs.

12345
DownloadUrlstring

The URL that is used to download the package of the export task. You can use the URL to download the package of the export task.

https://shanghai-xxx-oss.oss-cn-shanghai.aliyuncs.com/pre/store/f10_bf47_b4fa7df0860f.zip?Expires=1639540903&OSSAccessKeyId=XXXXXXeF4Lv5j&Signature=qxxxxx

Examples

Sample success responses

JSONformat

{
  "RequestId": "19999A96-71BA-2845-B455-ED620EF4E37F",
  "Success": true,
  "Data": {
    "MigrationId": 1234,
    "Name": "test_export_01",
    "GmtCreate": 1589904000000,
    "GmtModified": 1589904000000,
    "CreateUser": "982293332403****",
    "OpUser": "982293332403****",
    "Status": "EXPORT_SUCCESS",
    "ProjectId": 12345,
    "DownloadUrl": "https://shanghai-xxx-oss.oss-cn-shanghai.aliyuncs.com/pre/store/f10_bf47_b4fa7df0860f.zip?Expires=1639540903&OSSAccessKeyId=XXXXXXeF4Lv5j&Signature=qxxxxx"
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history