mgwutil update-address命令通過添加、刪除或設定代理來更新指定資料地址的代理配置，支援靈活操作且輸出明確的成功或失敗結果。 - Data Online Migration

mgwutil update-address命令通過添加、刪除或設定代理來更新指定資料地址的代理配置，支援靈活操作且輸出明確的成功或失敗結果。

命令格式

mgwutil update-address <address-name> [--add-agent <value>] [--delete-agent <value>] [--set-agent <value>]

參數說明

參數	必填	說明
address-name	是	待更新的資料位址名稱。
--add-agent	否	待添加的代理。
--delete-agent	否	待刪除的代理。
--set-agent	否	待設定的代理。

使用樣本

說明

請指定以下操作之一：添加（--add-agent）、刪除（--delete-agent）或設定（--set-agent）。

添加代理

使用--add-agent參數為資料地址添加新的代理。

mgwutil update-address mgwutil-address  --add-agent  "agent2,agent3"

刪除代理

當需要將部分代理從資料地址中移出時，可使用--delete-agent參數。

mgwutil update-address mgwutil-address  --delete-agent  "agent2,agent3"

更新代理

當需要將資料地址更新成指定的代理時，可使用--set-agent參數。

mgwutil update-address mgwutil-address  --set-agent  "agent1,agent2,agent3"

返回結果

成功返回

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

失敗返回

{
  "Code": "fail",
  "StatusCode": 404,
  "LogTime": "2026-01-16 11:55:52",
  "ErrorMsg": "SDKError:    StatusCode: 404    Code: NoSuchImportAddress    Message: The specified import address does not exist    Data: {'AccessDeniedDetail':null,'Recommend':null,'ecCode':null,'hostId':'1****96****9***5.cn-hangzhou.mgw.aliyuncs.com','requestId':'6969B6C84B18D73634B86340','statusCode':404} ",
  "ErrorCode": "NoSuchImportAddress",
  "RequestId": "6969B6C84B18D73634B86340"
}

錯誤碼

說明

錯誤碼錶示錯誤類別，詳情請參考錯誤資訊（ErrorMsg）。
此錯誤碼包含通用錯誤碼。

ErrorCode	說明
NoSuchImportAddress	指定的資料地址不存在，請確認資料位址名稱輸入無誤且該資料地址已完成建立。