Transit Gateway CLI

IBM Cloud® Transit Gateway コマンドラインは、 Transit Gateway サービスへのインターフェイスを提供する。 CLI を使用して、ゲートウェイおよび接続を作成して管理し、ゲートウェイに使用できるロケーションをリストできます。

開始前に

以下の手順に従って、IBM Cloud CLI プラグインとして実装されている Transit Gateway コマンド・ライン・インターフェースを使用します。

IBM Cloud CLI をインストールします。
tg-cli/tg CLI プラグインを IBM Cloud CLI にインストールします。

インストールするには、次のようにします。
```
ibmcloud plugin install tg
```

CLI を仮想プライベート・エンドポイント (VPE) で使用する場合は、以下の変数を設定する必要があります。

export IBMCLOUD_TG_API_ENDPOINT=private.transit.cloud.ibm.com

`ibmcloud plugin show tg`

Transit Gateway CLI プラグイン情報を表示します。

ibmcloud plugin show tg

Transit Gateway

このセクションでは、ゲートウェイ機能に関するCLIコマンドについて説明します。

`ibmcloud tg gateway`

特定のゲートウェイの詳細を取得します。

ibmcloud tg gateway|gw GATEWAY_ID [--output json] [-h, --help]

コマンド・オプション

GATEWAY_ID: 詳細を確認したいゲートウェイのID。
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

ゲートウェイの詳細を要求します。

ibmcloud tg gw $gateway

`ibmcloud tg gateways`

中継ゲートウェイをリストします。

ibmcloud tg gateways|gws [--output json] [-h, --help]

コマンド・オプション

--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

その他のコマンドでは、ゲートウェイIDが必要です。後で使えるように、IDを環境変数として保存しておきます。例えば、次のようにします

gateway="bdf8fa2b-c518-9999-9028-f3c9ece86159"

`ibmcloud tg gateway-create`

中継ゲートウェイを作成します。

ibmcloud tg gateway-create|gwc --name NAME --location LOCATION [--routing ROUTING][--gre-enhanced-route-propagation true | false] [--resource-group-id RES_GROUP_ID] [--output json] [-h, --help]

コマンド・オプション

--name: 新しいゲートウェイの名前。
--location: ゲートウェイの場所（ ibmcloud tg locations を使用して、可能な値を確認してください）
--routing: リソースのゲートウェイルーティング（global | local ）。リージョン間でリソースを接続するには、「 global 」を選択します。デフォルト値は localです。
--resource-group-id: オプション：ゲートウェイのリソースグループ ID。未指定の場合、デフォルトのリソース・グループを使用します。
--gre-enhanced-route-propagation: オプション：同じトランジットゲートウェイに接続されているすべてのGRE間でルート伝播を有効にするかどうかを指定します。有効な値は、 true および false （デフォルト）です。
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

us-south に local ルーティングを使用し、デフォルトのリソースグループを使用する myGateway という名前のゲートウェイを作成します。

ibmcloud tg gwc --name myGateway --location us-south

`ibmcloud tg gateway-delete`

既存のゲートウェイを削除します。

ibmcloud tg gateway-delete|gwd GATEWAY_ID [-f, --force] [-h, --help]

コマンド・オプション

GATEWAY_ID: 削除したいゲートウェイのID。
--force | -f: オプション：確認なしで強制的に削除する。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

確認を求めずにゲートウェイを削除します。

ibmcloud tg gwd $gateway -f

`ibmcloud tg gateway-update`

既存のゲートウェイでプロパティーを更新します。

ibmcloud tg gateway-update|gwu GATEWAY_ID [--name NAME] [--routing ROUTING] [--gre-enhanced-route-propagation true | false] [--output json] [-h, --help]

コマンド・オプション

GATEWAY_ID

更新対象のゲートウェイのID。

--name

任意：ゲートウェイの新しい名前。

--routing

オプション：リソースのゲートウェイルーティング（global | local ）。リージョン間でリソースを接続するには、「グローバル」を選択してください。 global から local へのルーティングを変更するには、既存のすべての接続を local に変更する必要があります。

--gre-enhanced-route-propagation

オプション：同じトランジットゲートウェイに接続されているすべてのGRE間でルート伝播を有効にするかどうかを指定します。有効な値は、 true および false （デフォルト）です。

この値を変更した後、変更が有効になるまで数分待つ。

--output json

オプション：出力をJSON形式で表示するかどうかを指定します。

--help | -h

オプション：このコマンドに関するヘルプを表示します。

例

ゲートウェイのルーティング値を「 global 」に更新してください。

ibmcloud tg gwu $gateway --routing global

接続

このセクションでは、接続機能に関するCLIコマンドについて説明します。

`ibmcloud tg acc-connections`

Transit Gateway上のすべてのアカウント接続をリストする。

ibmcloud tg acc-connections|ac [--network-id NETWORK_ID] [--network-type NETWORK_TYPE] [--all-pages] [--limit NUMERIC_VALUE] [--output json] [-h, --help]

コマンド・オプション

--network-id

オプション。 classic の場合は、値を設定しない。その他のネットワークタイプには、CRNを使用してください。たとえば、VPCのCRNを確認するには：

ibmcloud is vpc VPC_ID --json

--network-type: オプション。接続のネットワークの種類。値は classic、 directlink、 power_virtual_server、 vpn_gateway、 vpc。
--all-pages: オプション： --limit サイズが指定されているかどうかに関係なく、すべての接続をリストする。
--limit NUMERIC_VALUE: オプション：ページごとに返すリソースの最大数。デフォルトの制限値は 50 です。可能な値： 1 ≤ value ≤ 500
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

すべてのアカウント接続を一覧表示します：

ibmcloud tg acc-connections|ac

ネットワークタイプでフィルタリングされたアカウント接続のリスト：

ibmcloud tg acc-connections|ac --network-type vpc|classic|directlink|vpn_gateway|power_virtual_server

`ibmcloud tg connection`

特定の接続についての詳細を取得します。

ibmcloud tg connection|c GATEWAY_ID CONNECTION_ID [--output json] [-h, --help]

コマンド・オプション

GATEWAY_ID: 接続が行われているゲートウェイのID。
CONNECTION_ID: 詳細を確認したい接続のID。
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

特定の接続 ID の詳細を要求します。

ibmcloud tg c $gateway $connection

`ibmcloud tg connections`

Transit Gateway上の接続を一覧表示します。

ibmcloud tg connections|cs GATEWAY_ID [--all-pages] [--limit NUMERIC_VALUE] [--output json] [-h, --help]

コマンド・オプション

GATEWAY_ID: 接続対象とするゲートウェイのID。
--all-pages （現時点では、利用可能かどうかを選択してください）: --limit サイズが指定されているかどうかに関わらず、すべての接続をリストアップします。
--limit （現時点では、利用可能かどうかを選択してください）: 1ページに表示するリソースの最大数。デフォルトの制限値は 100 です。可能な値： 1 ≤ value ≤ 500
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

ゲートウェイでの接続をリストします。

ibmcloud tg cs $gateway

その他のコマンドでは、接続IDが必要です。後で使えるように、IDを環境変数として保存しておきます。例えば、次のようにします

connection="4892849f-368e-9999-bb58-8888fb21e513"

`ibmcloud tg connection-create`

Transit Gatewayで接続を作成します。

ibmcloud tg connection-create|cc GATEWAY_ID --name NAME --network-id NETWORK_ID --network-type NETWORK_TYPE --network-account-id ACCOUNT_ID [--zone ZONE] [--default-prefix-filter DEFAULT_PREFIX_FILTER] [--cidr CIDR] [--output json]

コマンド・オプション

GATEWAY_ID: 新しい接続が確立されているゲートウェイのID。
--name: 新しい接続の名前。
--network-id: ネットワーク接続のID。 classic の場合は、値を設定しない。その他のネットワークタイプには、CRNを使用してください。たとえば、VPCのCRNを確認するには：

ibmcloud is vpc VPC_ID --json

--network-type: 接続のネットワークの種類。値は classic、 directlink、 power_virtual_server、 vpn_gateway、 vpc。
--network-account-id: クラシック接続の作成に使用する IBM Cloud アカウントのID。接続のアカウントがゲートウェイのアカウントと異なる場合、 classic タイプでのみ使用されます。
--zone: オプション：GREトンネルまたはVPN接続を展開するアベイラビリティゾーン。 vpn_gateway ネットワークタイプにのみ適用される。
--default-prefix-filter: オプション：接続のデフォルトのプレフィックスフィルター（permit | deny ）。
--cidr: オプション：接続に使用するCIDRブロック。 vpn_gateway ネットワークタイプにのみ適用される。
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

vpc-connection という名前で、VPC接続を作成し、使用します。 vpcCRN="crn:v1:bluemix:public:is:us-south:a/3aa0a9999a1a46258064d84f7f447920::vpc:r134-f87014d5-87d2-46d1-9999-24683082f6bc"

ibmcloud tg cc $gateway --name vpc-connection --network-id $vpcCRN --network-type vpc

classic-conn という名前のクラシック接続を作成します。

ibmcloud tg cc $gateway --name classic-conn --network-type classic

`ibmcloud tg connection-delete`

既存の接続を削除します。

ibmcloud tg connection-delete|cd GATEWAY_ID CONNECTION_ID [-f, --force] [-h, --help]

コマンド・オプション

GATEWAY_ID: 削除される接続のゲートウェイのID。
CONNECTION_ID: 削除される接続のID。
--force | -f: オプション：確認なしで強制的に削除する。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

確認なしで接続を削除します。

ibmcloud tg cd $gateway $connection -f

`ibmcloud tg connection-create-gre`(非推奨)

コマンドは推奨されません。 tg-connection-gre-createコマンドを使用します。

Transit Gateway上で、汎用ルーティングカプセル化（GRE）トンネル接続を作成します。

ibmcloud tg connection-rcreate-gre|crgre GATEWAY_ID --name NAME --zone ZONE --local-gateway-ip LOCAL_GATEWAY_IP --local-tunnel-ip LOCAL_TUNNEL_IP --remote-gateway-ip REMOTE_GATEWAY_IP --remote-tunnel-ip REMOTE_TUNNEL_IP [--base-connection-id BASE_CONNECTION_ID] [--base-network-type BASE_NETWORK_TYPE] [--network-type NETWORK_TYPE] [--network-account-id NETWORK_ACCOUNT_ID] [--remote-bgp-asn REMOTE_BGP_ASN] [--default-prefix-filter DEFAULT_PREFIX_FILTER] [--output json]

コマンド・オプション

GATEWAY_ID 新しい接続がバインドされるゲートウェイのID。

--name: 新しいGRE接続の名前。
--zone: GREトンネルのアベイラビリティゾーン。例: us-south-1
--local-gateway-ip: GREトンネル接続用のローカルゲートウェイのIPアドレス。
--local-tunnel-ip: GREトンネル接続用のローカルトンネルIPアドレス。
--remote-gateway-ip: GREトンネル接続用のリモートゲートウェイのIPアドレス。
--remote-tunnel-ip: GREトンネル接続用のリモートトンネルIPアドレス。
--base-connection-id: オプション：GREトンネルのアンダーレイとなる従来のネットワーク接続のID。このオプションは、 gre_tunnel ネットワークタイプでのみ使用できます。
--base-network-type: ベース接続のネットワークタイプ（classic ）。
--network-type: オプション：GRE接続のネットワークタイプ。デフォルト値は gre_tunnelです。
--network-account-id: オプション：クラシック接続に接続するアカウントのID。接続先のアカウントがゲートウェイのアカウントと異なる場合は、 classic タイプでのみ使用してください。
--remote-bgp-asn: オプション：リモートBGP ASNが指定されていない場合、自動的に生成されます。
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

「 gre-connection 」という名前のGREトンネル接続を作成し、ベース接続として「 9037f710-8dfb-4948-a2bd-847c8dde96d3 」というクラシック接続を使用するように設定します。

ibmcloud tg connection-create-gre $gateway --name gre-connection --base-connection-id 9037f710-8dfb-9999-a2bd-847c8dde96d3  --zone us-south-2 --local-gateway-ip 192.168.100.1 --local-tunnel-ip 192.168.101.1 --remote-gateway-ip 10.242.63.12 --remote-tunnel-ip 192.168.101.2

`ibmcloud tg connection-approve`

ネットワーク所有者として、他のアカウントからの接続を承認します。

ibmcloud tg connection-approve|ca GATEWAY_ID CONNECTION_ID [-h, --help]

コマンド・オプション

GATEWAY_ID: 接続が行われているゲートウェイのID。
CONNECTION_ID: 承認する接続のID。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

接続要求を承認します。

ibmcloud tg ca $gateway $connection

`ibmcloud tg connection-gre-create`

トランジットゲートウェイ上で、GRE（Generic Routing Encapsulation）トンネルまたは無境界GRE接続を作成します。

ibmcloud tg connection-gre-create|cgrec GATEWAY_ID --name NAME --zone ZONE --local-gateway-ip LOCAL_GATEWAY_IP --local-tunnel-ip LOCAL_TUNNEL_IP --remote-gateway-ip REMOTE_GATEWAY_IP --remote-tunnel-ip REMOTE_TUNNEL_IP [--base-connection-id BASE_CONNECTION_ID] [--base-network-type BASE_NETWORK_TYPE] [--network-type NETWORK_TYPE] [--network-account-id NETWORK_ACCOUNT_ID] [--remote-bgp-asn REMOTE_BGP_ASN] [--default-prefix-filter DEFAULT_PREFIX_FILTER] [--output json]

コマンド・オプション

GATEWAY_ID: 新しい接続がバインドされるゲートウェイのID。
--name: 新しいGRE接続の名前。
--zone: GREトンネルのアベイラビリティゾーン。例: us-south-1
--local-gateway-ip: GREトンネル接続用のローカルゲートウェイのIPアドレス。
--local-tunnel-ip: GREトンネル接続用のローカルトンネルIPアドレス。
--remote-gateway-ip: GREトンネル接続用のリモートゲートウェイのIPアドレス。
--remote-tunnel-ip: GREトンネル接続用のリモートトンネルIPアドレス。
--base-connection-id: オプション：GREトンネルのアンダーレイとなる従来のネットワーク接続のID。このオプションは、 gre_tunnel ネットワークタイプでのみ使用できます。
--base-network-type: オプション：基本接続のネットワークタイプ（classic ）。
--network-type: オプション：GRE接続のネットワークタイプ。値は gre_tunnel または unbound_gre_tunnel です。デフォルト値はgre_tunnelです。
--network-account-id: オプション：クラシック接続に接続するアカウントのID。接続先のアカウントがゲートウェイのアカウントと異なる場合は、 classic タイプでのみ使用してください。
--remote-bgp-asn: オプション：リモートBGP ASNが指定されていない場合、自動的に生成されます。
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

ibmcloud tg connection-gre-create $gateway --name gre-connection --base-connection-id 9037f710-8dfb-9999-a2bd-847c8dde96d3  --zone us-south-2 --local-gateway-ip 192.168.100.1 --local-tunnel-ip 192.168.101.1 --remote-gateway-ip 10.242.63.12 --remote-tunnel-ip 192.168.101.2

`ibmcloud tg connection-reject`

ネットワーク所有者として、他のアカウントからの接続を拒否します。

ibmcloud tg connection-reject|cr GATEWAY_ID CONNECTION_ID [-h, --help]

コマンド・オプション

GATEWAY_ID: 接続が行われているゲートウェイのID。
CONNECTION_ID: 拒否する接続のID。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

接続要求を拒否します。

ibmcloud tg cr $gateway $connection

`ibmcloud tg connection-rgre-create`

トランジットゲートウェイ上で冗長GRE接続を作成します。

入力にはJSONファイルを使用する必要があります。

ibmcloud tg connection-rgre-create|crgrec --file JSON_FILE_PATH [--output json]

JSON ファイル

{
    "gateway_id": "47f11b01-471c-47d0-9e84-550c88c94055",
    "name": "redundant_gre1",
    "network_type": "redundant_gre",
    "base_network_type": "classic",
    "network_account_id": "28e4d90ac7504be694471ee66e70d0d5",
    "network_id": "crn:v1:bluemix:public:is:us-south:a/123456::vpc:4727d842-f94f-4a2d-824a-9bc9b02c523b",
    "tunnels": [
       {
          "local_gateway_ip": "192.168.100.1",
          "local_tunnel_ip": "192.168.129.2",
          "name": "gre1",
          "remote_bgp_asn": 65010,
          "remote_gateway_ip": "10.242.63.12",
          "remote_tunnel_ip": "192.168.129.1",
          "zone": {
             "name": "us-south-1"
          }
       }, {
          "local_gateway_ip": "192.168.101.1",
          "local_tunnel_ip": "192.168.128.2",
          "name": "gre2",
          "remote_bgp_asn": 65010,
          "remote_gateway_ip": "10.242.63.12",
          "remote_tunnel_ip": "192.168.128.1",
          "zone": {
             "name": "us-south-1"
          }
       }
    ]
}

コマンド・オプション

gateway_id: 新しい冗長GRE接続が設定されているゲートウェイのID。
name: 新しい冗長GRE接続の名前。
network_type: 接続のネットワークの種類。値は redundant_gre です。

base_network_type 使用するネットワークの種類。オプションは classic と vpc です。

network_account_id: アカウント間クラシックネットワークで使用する IBM Cloud アカウントのID。接続のアカウントがゲートウェイのアカウントと異なる場合、 classic タイプでのみ使用されます。このオプションは、 vpc ベースのネットワークタイプには適用できません。
network_id: 使用するVPCネットワークのCRN。このオプションは、 classic ベースのネットワークタイプには適用できません。たとえば、VPCのCRNを確認するには：

ibmcloud is vpc VPC_ID --json

tunnels

GREトンネルに関する情報。

local_gateway_ip

GREトンネル接続用のローカルゲートウェイのIPアドレス。このフィールドは、ネットワークタイプ redundant_gre 接続に必要なものです。

vpc ベースネットワークタイプを使用する場合、このIPアドレスはRFC1918に準拠し、 224.0.0.0 ～ 239.255.255.255 のマルチキャスト範囲内のIPアドレスであってはならず、トランジットゲートウェイに接続されている既存のネットワークと競合してはならない。また、このIPアドレスは、同じアンダーレイネットワークを使用する別のGREの local-gateway-ip。

local_tunnel_ip

Transit Gateway 側のトンネルに割り当てられたローカルトンネルIPアドレス。 local_tunnel_ip および remote_tunnel_ip のアドレスは、同じ /30 ネットワーク内にある必要があります。ネットワーク・アドレスやブロードキャスト・アドレスは使用できません。このフィールドは、ネットワークタイプ redundant_gre 接続に必要なものです。

name

GREトンネルの名称。

remote_bgp_asn

オプション：リモートBGP ASNが指定されていない場合、自動的に生成されます。

remote_gateway_ip

GREトンネル接続用のリモートゲートウェイのIPアドレス。

remote_tunnel_ip

GREトンネル接続用のリモートトンネルIPアドレス。

zone

GREトンネルのアベイラビリティゾーン。例: us-south-1

`ibmcloud tg connection-update`

既存の接続でプロパティーを更新します。

ibmcloud tg connection-update|cu GATEWAY_ID CONNECTION_ID --name NAME [--output json] [-h, --help]

コマンド・オプション

GATEWAY_ID: 接続の更新が行われているゲートウェイのIDは次のとおりです。
CONNECTION_ID: 更新対象の接続のID。
--name: 接続の新しい名前。
--default-prefix-filter: オプション：接続のデフォルトのプレフィックスフィルター（permit | deny ）。
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

接続名を MyConn2 に更新します。

ibmcloud tg cu $gateway $connection --name MyConn2

`ibmcloud tg redundant-gre-tunnel-add`

冗長化されたGREにトンネルを追加する。

ibmcloud tg redundant-gre-tunnel-add|targre GATEWAY_ID REDUNDANT_GRE_ID --name NAME --zone ZONE --local-gateway-ip LOCAL_GATEWAY_IP --local-tunnel-ip  LOCAL_TUNNEL_IP --remote-gateway-ip REMOTE_GATEWAY_IP --remote-tunnel-ip REMOTE_TUNNEL_IP [--remote-bgp-asn REMOTE_BGP_ASN] [--output json]

コマンド・オプション

GATEWAY_ID: 新しい接続がバインドされるゲートウェイのID。
REDUNDANT_GRE_ID: 冗長GRE接続のID。
--name: 新しいGREトンネルの名前。
--zone: GREトンネルのアベイラビリティゾーン。例: us-south-1
--local-gateway-ip: GREトンネル接続用のローカルゲートウェイのIPアドレス。
--local-tunnel-ip: GREトンネル接続用のローカルトンネルIPアドレス。
--remote-gateway-ip: GREトンネル接続用のリモートゲートウェイのIPアドレス。
--remote-tunnel-ip: GREトンネル接続用のリモートトンネルIPアドレス。
--remote-bgp-asn: オプション：リモートBGP ASNが指定されていない場合、自動的に生成されます。
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

ibmcloud tg redundant-gre-tunnel-add e47d6b9c-095f-4d31-aa47-5c89c2ded820 e4e37e31-8895-4594-be6b-61e8088b53c7 --name gre-tunnel3  --zone us-south-3 --local-gateway-ip 192.193.202.1 --local-tunnel-ip 192.193.237.2 -ibmcloud login -a https://cloud.ibm.com -r us-south --sso -remote-gateway-ip 10.186.203.5 --remote-tunnel-ip 192.193.237.1

`ibmcloud tg redundant-gre-tunnel-remove`

冗長GREからトンネルを削除する。

ibmcloud tg redundant-gre-tunnel-remove|trrgre GATEWAY_ID REDUNDANT_GRE_ID TUNNEL_ID [--force | -f] [--help | -h]

コマンド・オプション

GATEWAY_ID: 新しい接続がバインドされるゲートウェイのID。
REDUNDANT_GRE_ID: 冗長GRE接続のID。
TUNNEL_ID: 削除対象のトンネルのID。
--force | -f: オプション：確認なしで強制的に削除する。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

ibmcloud tg redundant-gre-tunnel-remove e47d6b9c-095f-4d31-aa47-5c89c2ded820 e4e37e31-8895-4594-be6b-61e8088b53c7 b97a5cf5-7ee4-4073-b719-f6df36dea08f

`ibmcloud tg tunnels`

指定した冗長GRE配下のすべてのトンネルをリストアップします。

ibmcloud tg tunnels|ts GATEWAY_ID REDUNDANT_GRE_ID [--output json]

コマンド・オプション

GATEWAY_ID: 新しい接続がバインドされるゲートウェイのID。
REDUNDANT_GRE_ID: 冗長GRE接続のID。
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--force | -f: オプション：確認なしで強制的に削除する。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

ibmcloud tg ts e47d6b9c-095f-4d31-aa47-5c89c2ded820 e4e37e31-8895-4594-be6b-61e8088b53c7

ロケーション

このセクションでは、位置情報機能に関するCLIコマンドについて説明します。

`ibmcloud tg locations`

考えられるロケーションをリストしてゲートウェイを作成するには、以下のコマンドを使用します。

ibmcloud tg locations|locs [--output json] [-h, --help]

コマンド・オプション

--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

`ibmcloud tg location`

このロケーションに固有の情報を取得します。

ibmcloud tg location|loc NAME [--output json] [-h, --help]

コマンド・オプション

NAME: 詳細を確認したい場所の名前。
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

ロケーション us-south の詳細を要求します。

ibmcloud tg location us-south

接続プレフィックスフィルタ

このセクションでは、接続プレフィックスフィルタ機能に関するCLIコマンドの情報を提供します。

`ibmcloud tg prefix-filter-create`

接続に接頭部フィルターを追加します。

ibmcloud tg prefix-filter-create GATEWAY_ID CONNECTION_ID --prefix PREFIX --action ACTION [--le LE] [--ge GE] [--before BEFORE] [--output json]

コマンド・オプション

GATEWAY_ID: プレフィックスフィルタが適用されているゲートウェイのID。
CONNECTION_ID: プレフィックスフィルタが適用されている接続のID。
--prefix: フィルタが適用されるネットワークプレフィックス。
--action: 指定されたプレフィックスに対して実行するアクション（permit | deny ）。
--le: オプション：この値以下であるサブネットマスクに適用されるプレフィックスフィルター。
--ge: オプション：この値以上となるサブネットマスクに適用されるプレフィックスフィルター。
--before: オプション：このフィルターを適用する前に適用すべきプレフィックスフィルターの識別子。空の場合、このフィルターは最後に適用されます。
--output: オプション：出力形式を指定します。 json のみがサポートされています。すべての詳細が表示される。

例

10.0.250.0/24の接頭部フィルターをゲートウェイ9f559c43-63f4-4da5-b312-b525a8dce185に追加し、アクションpermitによって 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7接続します。

ibmcloud tg pfc 9f559c43-63f4-4da5-b312-b525a8dce185 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7 --prefix 10.0.250.0/24 --action permit

`ibmcloud tg prefix-filter-delete`

接続から接頭部フィルターを削除します。

ibmcloud tg prefix-filter-delete GATEWAY_ID CONNECTION_ID FILTER_ID [-f, --force]

コマンド・オプション

GATEWAY_ID: プレフィックスフィルタが削除されるゲートウェイのID。
CONNECTION_ID: プレフィックスフィルタが削除された接続のID。
FILTER_ID: 削除されるプレフィックスフィルターのID。
--force, -f: 確認なしで削除操作を強制的に実行します。

例

ゲートウェイ9f559c43-63f4-4da5-b312-b525a8dce185および接続6c1bdc19-4adb-4760-8cdc-ef3b74b626f7から接頭部フィルター IDb4dbe0a6-c52d-4128-cc32-6f53d86bc82bを削除します。

ibmcloud tg pfd 9f559c43-63f4-4da5-b312-b525a8dce185 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7 b4dbe0a6-c52d-4128-cc32-6f53d86bc82b

ルート・レポート

このセクションでは、ルートレポート機能に関するCLIコマンドについて説明します。

`ibmcloud tg route-reports`

このコマンドは、ゲートウェイで使用可能なルート・レポートをリストするために使用します。

ibmcloud tg route-reports|rrs GATEWAY_ID [--output json] [-h, --help]

コマンド・オプション

GATEWAY_ID: ルートレポートの一覧を表示するゲートウェイのID。
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

ゲートウェイでルート・レポートをリストします。

ibmcloud tg rrs $gateway

その他のコマンドでは、ルートレポートIDが必要です。後で使えるように、IDを環境変数として保存しておきます。例えば、次のようにします

report="4892849f-368e-9999-4444-8888fb21e513"

`ibmcloud tg route-report`

特定のルート・レポートに関する詳細を取得します。

ibmcloud tg route-report|rr GATEWAY_ID REPORT_ID [--output json] [-h, --help]

コマンド・オプション

GATEWAY_ID: ルートレポートの発信元となるゲートウェイのID。
REPORT_ID: 詳細を確認したいルートレポートのID。
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

ルート・レポートの詳細を要求します。

ibmcloud tg rr $gateway $report

`ibmcloud tg route-report-create`

ルート・レポートを作成します。

ibmcloud tg route-report-create|rrc GATEWAY_ID [--output json] [-h, --help]

コマンド・オプション

GATEWAY_ID: ルートレポートが作成されるゲートウェイのID。
--output json: オプション：出力をJSON形式で表示するかどうかを指定します。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

ゲートウェイのルート・レポートを作成します。

ibmcloud tg rrc $gateway

`ibmcloud tg route-report-delete`

既存のルート・レポートを削除します。

ibmcloud tg route-report-delete|rrd GATEWAY_ID REPORT_ID [-f, --force] [-h, --help]

コマンド・オプション

GATEWAY_ID: レポートの対象となるゲートウェイのID。
REPORT_ID: 削除したいレポートのID。
--force | -f: オプション：確認なしで強制的に削除する。
--help | -h: オプション：このコマンドに関するヘルプを表示します。

例

確認なしでルート・レポートを削除します。

ibmcloud tg rrd $gateway $report -f

Transit Gateway CLI

Transit Gateway CLI

開始前に

ibmcloud plugin show tg

Transit Gateway

ibmcloud tg gateway

コマンド・オプション

例

ibmcloud tg gateways

コマンド・オプション

ibmcloud tg gateway-create

コマンド・オプション

例

ibmcloud tg gateway-delete

コマンド・オプション

例

ibmcloud tg gateway-update

コマンド・オプション

例

接続

ibmcloud tg acc-connections

コマンド・オプション

例

ibmcloud tg connection

コマンド・オプション

例

ibmcloud tg connections

コマンド・オプション

例

ibmcloud tg connection-create

コマンド・オプション

例

ibmcloud tg connection-delete

コマンド・オプション

例

ibmcloud tg connection-create-gre(非推奨)

コマンド・オプション

例

ibmcloud tg connection-approve

コマンド・オプション

例

ibmcloud tg connection-gre-create

コマンド・オプション

例

ibmcloud tg connection-reject

コマンド・オプション

例

ibmcloud tg connection-rgre-create

JSON ファイル

コマンド・オプション

ibmcloud tg connection-update

コマンド・オプション

例

ibmcloud tg redundant-gre-tunnel-add

コマンド・オプション

例

ibmcloud tg redundant-gre-tunnel-remove

コマンド・オプション

例

ibmcloud tg tunnels

コマンド・オプション

例

ロケーション

ibmcloud tg locations

コマンド・オプション

ibmcloud tg location

コマンド・オプション

例

接続プレフィックスフィルタ

ibmcloud tg prefix-filter-create

コマンド・オプション

例

ibmcloud tg prefix-filter-delete

コマンド・オプション

例

ルート・レポート

ibmcloud tg route-reports

コマンド・オプション

例

ibmcloud tg route-report

`ibmcloud plugin show tg`

`ibmcloud tg gateway`

`ibmcloud tg gateways`

`ibmcloud tg gateway-create`

`ibmcloud tg gateway-delete`

`ibmcloud tg gateway-update`

`ibmcloud tg acc-connections`

`ibmcloud tg connection`

`ibmcloud tg connections`

`ibmcloud tg connection-create`

`ibmcloud tg connection-delete`

`ibmcloud tg connection-create-gre`(非推奨)

`ibmcloud tg connection-approve`

`ibmcloud tg connection-gre-create`

`ibmcloud tg connection-reject`

`ibmcloud tg connection-rgre-create`

`ibmcloud tg connection-update`

`ibmcloud tg redundant-gre-tunnel-add`

`ibmcloud tg redundant-gre-tunnel-remove`

`ibmcloud tg tunnels`

`ibmcloud tg locations`

`ibmcloud tg location`

`ibmcloud tg prefix-filter-create`

`ibmcloud tg prefix-filter-delete`

`ibmcloud tg route-reports`

`ibmcloud tg route-report`

`ibmcloud tg route-report-create`

`ibmcloud tg route-report-delete`