mgwutil工具支援通過命令列更新任務狀態和限流策略，包括啟動、暫停及調整頻寬與QPS參數。 - Data Online Migration

您可以使用該系列命令更新任務狀態和限流策略。

啟動任務

命令格式

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	指定的任務不存在，請確認任務名稱輸入無誤且該任務已完成建立。