任务状态更新与限流策略调整命令-在线迁移服务-阿里云

您可以使用该系列命令更新任务状态和限流策略。

启动任务

命令格式

mgwutil start-job <job-name>

参数说明

参数	必填	说明
job-name	是	待启动的任务名称。

使用示例

mgwutil start-job mgwutil-abc

成功响应

{
  "Code":      "success" ,
  "StatusCode": 200,
  "LogTime": "2024-12-25 17:51:37",
  "Data":       {}
}

失败响应

{
  "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"
}

暂停任务

命令格式

mgwutil pause-job <job-name>

参数说明

参数	必填	说明
job-name	是	待暂停的任务名称。

使用示例

mgwutil pause-job mgwutil-abc

成功响应

{
  "Code":      "success" ,
  "StatusCode": 200,
  "LogTime": "2025-12-25 17:51:37",
  "Data":       {}
}

失败响应

{
  "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"
}

关闭任务

命令格式

mgwutil close-job <job-name>

参数说明

参数	必填	说明
job-name	是	待关闭的任务名称。

使用示例

mgwutil close-job mgwutil-abc

成功响应

{
  "Code":      "success" ,
  "StatusCode": 200,
  "LogTime": "2025-12-25 17:51:37",
  "Data":       {}
}

失败响应

{
  "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"
}

更新任务限流策略

命令格式

mgwutil update-qos <job-name> [--max-bandwidth <value>] [--max-qps <value>]

参数说明

参数	必填	说明
job-name	是	待更新限流策略的任务名称。
--max-bandwidth	是	待更新的流量限制，单位为bits/s。
--max-qps	是	待更新的QPS限制。

使用示例

mgwutil update-qos mgwutil-abc --max-bandwidth 1000000 --max-qps 1000

成功响应

{
  "Code":      "success" ,
  "StatusCode": 200,
  "LogTime": "2025-12-25 17:51:37",
  "Data":       {}
}

失败响应

{
  "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	说明
NoSuchImportJob	指定的任务不存在，请确认任务名称输入无误且该任务已完成创建。