使用mgwutil update-tunnel命令更新通道流控参数-在线迁移服务-阿里云

mgwutil update-tunnel命令用于通过指定通道ID更新通道流控参数，包括最大QPS、带宽限制及标记，并返回操作结果状态。

命令格式

mgwutil update-tunnel <tunnel-id> [--max-qps <value>] [--max-bandwidth <value>] [--tags <value>]

参数说明

参数	必填	说明
tunnel-id	是	通道ID，可在创建通道的返回结果中获取。
--max-qps	否	设定通道的每秒最大请求数（QPS）限制。
--max-bandwidth	否	设定通道的最大带宽限制，单位 Byte/s。
--tags	否	通道标签。

使用示例

将通道 tun-g6q2oota7182 的最大 QPS 设置为 1000，最大带宽设置为 100 MB/s。

# 104857600 Byte/s 等于 100 MB/s
mgwutil update-tunnel tun-g6q2oota7182 --max-qps 1000 --max-bandwidth 104857600

返回结果

成功返回

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

失败返回

{
  "Code": "fail",
  "StatusCode": 404,
  "LogTime": "2026-01-16 10:10:33",
  "ErrorMsg": "SDKError:    StatusCode: 404    Code: NoSuchImportTunnel    Message: The specified import tunnel does not exist    Data: {'AccessDeniedDetail':null,'Recommend':null,'ecCode':null,'hostId':'11***963876***55.cn-hangzhou.mgw.aliyuncs.com','requestId':'69699E196683E5383727FAAA','statusCode':404} ",
  "ErrorCode": "NoSuchImportTunnel",
  "RequestId": "69699E196683E5383727FAAA"
}

错误码

说明

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

ErrorCode	说明
NoSuchImportTunnel	通道不存在。
ImportTunnelNotBelongTo	通道属于其他用户。