create-tunnel コマンドは mgwutil ツールを使用してチャンネルリソースを作成および設定します。QPS、帯域幅、タグなどのパラメーターを設定して、詳細なトラフィック管理をサポートします。 - Data Online Migration

mgwutil create-tunnel を使用して、チャンネルリソースを作成および設定します。

コマンドフォーマット

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

パラメーターの説明

パラメーター	必須	説明
--max-qps	いいえ	チャンネルの 1 秒あたりの最大クエリ数 (QPS) 制限。値は負でない整数である必要があります。デフォルト値は 0 で、QPS 制限がないことを示します。このパラメーターは、複数のタスクグループ間でレート制限が使用される場合にのみ適用されます。最適な移行効率を得るためには、まずタスクレベルでレート制限を設定することを推奨します。
--max-bandwidth	いいえ	チャンネルの最大帯域幅制限。単位はバイト/秒 (Byte/s) です。デフォルト値は 0 で、帯域幅制限がないことを示します。 0 より大きい値を設定する場合、10485760 (10 MB/s) 以上である必要があります。このパラメーターは、複数のタスクグループ間でレート制限が使用される場合にのみ適用されます。最適な移行効率を得るためには、まずタスクレベルでレート制限を設定することを推奨します。
--tags	いいえ	チャンネルにタグを割り当てます。タグは空にすることもできます。使用可能な文字には、大文字と小文字の英字、数字、および特殊文字 `-_` が含まれます。すべてのタグコンテンツの合計長は 1 KB を超えることはできません。

使用例

次のコマンドを実行して、最大 1000 QPS (クエリ/秒) および最大帯域幅 8 Gbps のチャンネルを作成します。

 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 です。