使用mgwutil retry-job命令创建重试子任务处理失败文件-在线迁移服务-阿里云

当父任务已完成、存在失败文件且这些文件处于可重试状态时，您可以使用 mgwutil retry-job 命令创建一个重试子任务处理这些失败文件。

命令格式

mgwutil retry-job <job-name> [--access-secret]

参数说明

参数	必填	说明
job-name	是	待重试的任务名称。
--access-secret	否	当重试任务的源地址为OSS、OSSINV、Local类型时，此参数可不填；否则（如S3、QINIU等）此参数必填，其值为对应的AccessSecret，用于创建重试任务的源地址。

使用示例

重试OSS、OSSINV、LOCAL任务

mgwutil retry-job mgwutil-job

重试第三方源（非OSS）任务

mgwutil retry-job mgwutil-job --access-secret *******

返回结果

成功返回

{
  "Code":      "success" ,
  "StatusCode": 200,
  "LogTime": "2025-12-25 17:51:37",
  "Data": { 
     "WaitRetryJob": "test-1",
     "RetryJob":     "test-1_retry_20250715150504",
     "RootJob":      "test-1"
  }
}

失败返回

{
  "Code": "fail",
  "StatusCode": 404,
  "LogTime": "2026-01-16 13:59:25",
  "ErrorMsg": "SDKError:    StatusCode: 404    Code: NoSuchImportJob    Message: The specified import job does not exist    Data: {'AccessDeniedDetail':null,'Recommend':null,'ecCode':null,'hostId':'1****96****94***.cn-hangzhou.mgw.aliyuncs.com','requestId':'6969D3BD5CCFC933302EC1A4','statusCode':404} ",
  "ErrorCode": "NoSuchImportJob",
  "RequestId": "6969D3BD5CCFC933302EC1A4"
}

错误码

说明

错误码表示错误类别，详情请参考错误信息（ErrorMsg）。
此错误码包含通用错误码。

ErrorCode	说明
JobIsInterrupted	父任务处于中断状态。
JobIsNotFinished	父任务尚未结束。
HistoryIsEmpty	调用 `ListJobHistory` 接口返回的 Body 为空。
HistoryNoNeedRetry	`ListJobHistory` 接口返回的 `FailedCount` 字段值小于或等于 0。
ResultNoNeedRetry	`GetJobResult` 接口返回的结果表明任务无需重试。
ResultNotReadyRetry	`GetJobResult` 接口返回的结果表明任务重试尚未就绪。
VerifyAddressUnavailable	`VerifyAddress` 接口返回的结果表明该数据地址无效。