使用mgwutil delete-agent删除代理-在线迁移服务-阿里云

使用 mgwutil delete-agent命令可交互式或强制删除指定代理。

重要

删除操作为不可逆操作，删除前务必反复确认。

命令格式

mgwutil delete-agent <agent-name> [--force]

参数说明

参数	必填	说明
agent-name	是	待删除的代理名称。
--force	否	是否强制执行删除（非交互式执行）操作，默认不开启。

使用示例

交互式

执行删除命令并根据提示进行确认，这是默认的安全操作模式，可以有效防止误删。

mgwutil delete-agent  mgwutil_agent-12

输入上述命令后，屏幕会显示下列提示请求用户确认是否需要删除代理。

please confirm if you want to delete agent: (y/n)

输入 n 并按回车键，操作将中止，屏幕会打印 cancel the delete agent operation提示，表示取消了该删除操作。
输入 y 并按回车键，确认删除。

强制删除（非交互式）

强制删除指定代理 mgwutil_agent-12。

警告

您可以使用以下命令强制删除指定代理。请注意，此操作不可逆，请谨慎操作。

mgwutil delete-agent  mgwutil_agent-12 --force

返回结果

成功返回

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

失败返回

{
  "Code": "fail",
  "StatusCode": 409,
  "LogTime": "2026-01-16 11:24:02",
  "ErrorMsg": "SDKError:    StatusCode: 409    Code: ImportAgentIsOccupied    Message: The import agent is occupied by import address    Data: {'AccessDeniedDetail':null,'Recommend':null,'ecCode':null,'hostId':'1****9****69***5.cn-hangzhou.mgw.aliyuncs.com','requestId':'6969AF52F8BE36363969434D','statusCode':409} ",
  "ErrorCode": "ImportAgentIsOccupied",
  "RequestId": "6969AF52F8BE36363969434D"
}

错误码

说明

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

ErrorCode	说明
CancelOperation	取消删除操作。
InvalidInput	确认输入无效，请仅输入 'y' 表示确认或 'n' 表示取消。
ImportAgentIsOccupied	该代理已被指定的数据地址占用。