All Products
Search
Document Center

Data Online Migration:GetJobResult

Last Updated:Jun 16, 2025

Obtains the list of files that fail to be migrated when files fail to be migrated during a migration task.

Operation description

  • To query the retry information about a migration task, you must have the permission on mgw:GetImportJobResult.
  • If files fail to be migrated during a migration task, a list of files that fail to be migrated is generated. You can call this operation to query this list. You can create a data address based on this list and create a subtask. This way, you can migrate these files again.

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

GET /job/{jobName}?jobResult HTTP/1.1 Host: userid.cn-hangzhou.mgw.aliyuncs.com

Request parameters

ParameterTypeRequiredDescriptionExample
jobNamestringYes

The task name.

1
runtimeIdstringYes

The execution ID of the task.

2

Response parameters

ParameterTypeDescriptionExample
object

The response body.

ImportJobResultGetJobResultResp

The details for obtaining the retries of the migration task.

Examples

Sample success responses

JSONformat

{
  "ImportJobResult": {
    "ReadyRetry": "Ready",
    "InvPath": "mainfest.json",
    "InvBucket": "test_sys_bucket",
    "InvDomain": "test_domain",
    "InvLocation": "oss",
    "InvAccessId": "test_access_id",
    "InvAccessSecret": "test_secret_key",
    "InvRegionId": "test_region_id",
    "AddressType": "ossinv",
    "TotalObjectCount": 1000,
    "CopiedObjectCount": 800,
    "FailedObjectCount": 200,
    "TotalObjectSize": 1000,
    "CopiedObjectSize": 800,
    "Version": "test_job_id"
  }
}

XMLformat

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ImportJobResult>
  <ReadyRetry>Ready</ReadyRetry>
  <InvPath>mainfest.json</InvPath>
  <InvBucket>test_sys_bucket</InvBucket>
  <InvDomain>test_domain</InvDomain>
  <InvLocation>oss</InvLocation>
  <InvAccessId>test_access_id</InvAccessId>
  <InvAccessSecret>test_secret_key</InvAccessSecret>
  <InvRegionId>test_region_id</InvRegionId>
  <AddressType>ossinv</AddressType>
  <TotalObjectCount>1000</TotalObjectCount>
  <CopiedObjectCount>800</CopiedObjectCount>
  <FailedObjectCount>200</FailedObjectCount>
  <TotalObjectSize>1000</TotalObjectSize>
  <CopiedObjectSize>800</CopiedObjectSize>
  <Version>test_job_id</Version>
</ImportJobResult>

Error codes

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