使用mgwutil create-tunnel命令创建通道并设置限流-在线迁移服务-阿里云

使用mgwutil create-tunnel创建并配置通道资源。

命令格式

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

参数说明

参数	必填	说明
--max-qps	否	通道的最大 QPS（每秒请求数）限制。取值范围为非负整数。默认值为 0，表示不限制 QPS。该参数仅在多任务组合限流时使用。建议优先对任务级别设置限流策略，以最优化迁移效率。
--max-bandwidth	否	通道的最大带宽限制，单位为 Byte/s。默认值为 0，表示不限制带宽。若设置大于 0 的值，则该值不得低于 10485760（10 MB/s）。该参数仅在多任务组合限流时使用。建议优先对任务级别设置限流策略，以最优化迁移效率。
--tags	否	为通道设置标签可以为空。允许的字符集为英文大小写字母、数字和特殊字符 `-_`。标签内容总长度不能超过 1 KB。

使用示例

执行以下命令，创建一个最大 QPS 为 1000，最大带宽为 8Gbps 的通道。

 mgwutil create-tunnel --max-qps 1000 --max-bandwidth 1073741824

返回结果

成功返回

{
  "Code": "success",
  "StatusCode": 200,
  "LogTime": "2025-12-25 17:51:37",
  "Data": {
      "CreateTime": "2025-07-15T11:40:47.000Z",
      "TunnelId": "****-***-***-***-***"
  }
}

失败返回

{
    "Code":      "fail" ,
    "StatusCode": 400,
    "ErrorCode": "InvalidCommand",
    "LogTime": "2025-12-25 17:51:37",
    "ErrorMsg":  “unknown command 'aaa' for 'mgwutil create-tunnel'",
    "RequestId": ""
}

错误码

说明

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

ErrorCode	说明
ImportTunnelNumExceed	通道总数超过限制，默认限制50。