Transit Gateway CLI

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

開始前に

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

  1. IBM Cloud CLI をインストールします。

  2. 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] [--redundancy-group GROUP_NAME] [--redundancy-group-id GROUP_ID] [--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です。

--redundancy-group

オプション:グローバル Transit Gatewayの冗長性グループを名前で指定します。 グループ名が存在しない場合は、作成されます。 存在する場合、ゲートウェイはそのグループに参加します。

--routing global が指定されている場合にのみ有効です。

--redundancy-group-id

オプション:グローバル Transit Gatewayに対して、既存の冗長性グループの ID を指定します。 このオプションは、冗長性グループがすでに存在しており、ID に基づいてゲートウェイをそのグループに追加したい場合に使用します。

--routing global が指定されている場合にのみ有効です。

冗長化グループは、グローバルトランジットゲートウェイでのみサポートされています。

--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] [--redundancy-group GROUP_NAME] [--gre-enhanced-route-propagation true | false] [--output json] [-h, --help]

コマンド・オプション

GATEWAY_ID
更新対象のゲートウェイのID。
--name
任意:ゲートウェイの新しい名称。
--routing
オプション:リソースのゲートウェイルーティング(global | local)。リージョンをまたいでリソースを接続するには、グローバルを選択してください。 ルーティングを から に変更 global するには、既存のすべての接続を にする local 必要があります local。

ゲートウェイが冗長化グループに属している場合、ルーティングを変更することはできません。

--redundancy-group

オプション:ゲートウェイが属する冗長化グループの名前を更新します。 この設定は、ゲートウェイがすでに冗長化グループに属しており、グローバルルーティングが有効になっている場合にのみ有効です。 グループの名前を変更すると、関連付けられているすべてのトランジットゲートウェイに対してその変更が反映されます。

--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、および dynamic_route_server Beta です。

--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|dynamic_route_server [Beta]{: tag-cyan}

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、および dynamic_route_server Beta です。

--network-account-id
クラシック接続の作成に使用する IBM Cloudアカウント ID。 接続先のアカウントがゲートウェイのアカウントと異なる場合、 classic type とともにのみ使用されます。

--zone

: オプション:GREトンネルまたはVPN接続を展開するアベイラビリティゾーン。 vpn_gateway ネットワークタイプに適用されます。 dynamic_route_server 接続( Beta )の場合、 --zone フラグは無視されます。

 リージョナル VPN ゲートウェイ(`availability_mode: regional`)を接続する `--zone` 際は、を指定しないでください。ゾーンの配置は、VPN ゲートウェイのメンバー構成から自動的に決定されます。 リージョナル VPN ゲートウェイのゾーンを指定すると、エラーが発生します。
 {: note}

--default-prefix-filter

: オプション:接続のデフォルトのプレフィックスフィルター(permit | deny )。 dynamic_route_server 接続 Beta ではサポートされていません。このタイプの接続でこのフラグを指定すると、エラーが返されます。

--cidr

: オプション:接続に使用するCIDRブロック。 vpn_gateway および dynamic_route_server Beta のネットワークタイプにのみ適用されます。 指定がない場合、両方の接続タイプに対して、デフォルトの範囲 198.19.174.0/23 が使用されます。

--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

Beta

CIDR を指定せずに動的なルートサーバー接続を作成します(CIDR は自動的に割り当てられます):

ibmcloud tg cc $gateway \
  --name drs-connection \
  --network-type dynamic_route_server \
  --network-id $drsCRN

明示的なCIDRを使用して、動的なルートサーバー接続を作成します:

ibmcloud tg cc $gateway \
  --name drs-connection-with-cidr \
  --network-type dynamic_route_server \
  --network-id $drsCRN \
  --cidr 198.19.176.0/23

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。 接続先のアカウントがゲートウェイのアカウントと異なる場合にのみ、type classic を使用してください。
--remote-bgp-asn
オプション:リモート BGP ASN が指定されていない場合、自動的に生成されます。
--output json
オプション:出力をJSON形式で表示するかどうかを指定してください。
--help | -h
オプション:このコマンドに関するヘルプを表示します。

例

という名前の GRE トンネル接続を作成し gre-connection 、ベース接続 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。 接続先のアカウントがゲートウェイのアカウントと異なる場合にのみ、type classic を使用してください。
--remote-bgp-asn
オプション:リモート BGP ASN が指定されていない場合、自動的に生成されます。
--output json
オプション:出力をJSON形式で表示するかどうかを指定してください。
--help | -h
オプション:このコマンドに関するヘルプを表示します。

例

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

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 type とともにのみ使用されます。 このオプションは、 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

冗長化グループ

このセクションでは、冗長性グループ機能に関するCLIコマンドについて説明します。

ibmcloud tg redundancy-groups

アカウント内のすべての冗長化グループを一覧表示します。

ibmcloud tg redundancy-groups|rgs [--output json] [-h, --help]

例

アカウント内のすべての冗長化グループを一覧表示します。

ibmcloud tg rgs

ibmcloud tg redundancy-group

冗長性グループを取得します。

ibmcloud tg redundancy-group|rg ID [--output json] [-h, --help]

コマンド・オプション

ID

取得したい冗長化グループのID。

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

例

冗長性グループを取得します。

ibmcloud tg rg $redundancy_group_id

ibmcloud tg redundancy-group-update

冗長性グループを更新します。

ibmcloud tg redundancy-group-update|rgu ID --name NEW_NAME [--output json] [-h, --help]

コマンド・オプション

ID

更新対象の冗長化グループのID。

--name NEW_NAME
整数グループの新しい名称。 そのアカウントですでに使用されている名前は使用できません。
--output json
オプション:出力をJSON形式で表示するかどうかを指定してください。
--help | -h
オプション:このコマンドに関するヘルプを表示します。

例

冗長性グループを更新します。

ibmcloud tg rgu $redundancy_group_id --name NEW_NAME