使用mgwutil delete-tunnel命令以交互或强制方式删除通道-在线迁移服务-阿里云

mgwutil delete-tunnel命令通过指定通道ID删除通道，支持交互式确认和强制删除选项。

命令格式

mgwutil delete-tunnel <tunnel-id> [--force]

参数说明

参数	必填	说明
tunnel-id	是	需要删除的通道ID，可在创建通道的返回结果中获取。
--force	否	是否强制执行删除（非交互式执行）操作，默认不开启。

使用示例

交互式

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

mgwutil delete-tunnel  ****-***-***-***-***

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

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

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

强制删除（非交互式）

以下示例展示如何强制删除指定通道（非交互式）。

mgwutil delete-tunnel  ****-***-***-***-*** --force

警告

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

返回结果

成功返回

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

失败返回

{
  "Code": "fail",
  "StatusCode": 409,
  "LogTime": "2026-01-16 10:08:07",
  "ErrorMsg": "SDKError:    StatusCode: 409    Code: ImportTunnelIsOccupied    Message: The import tunnel is occupied by import agent    Data: {'AccessDeniedDetail':null,'Recommend':null,'ecCode':null,'hostId':'11***9638769***5.cn-hangzhou.mgw.aliyuncs.com','requestId':'69699D87847D9E38353E99BB','statusCode':409} ",
  "ErrorCode": "ImportTunnelIsOccupied",
  "RequestId": "69699D87847D9E38353E99BB"
}

错误码

说明

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

ErrorCode	说明
CancelOperation	取消删除操作。
InvalidInput	确认输入无效，请仅输入 'y' 表示确认或 'n' 表示取消。
ImportTunnelNotBelongTo	通道归属于其他用户。
ImportTunnelIsOccupied	通道已被占用。