使用mgwutil update-address更新数据地址的代理配置-在线迁移服务-阿里云

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	指定的数据地址不存在，请确认数据地址名称输入无误且该数据地址已完成创建。