Transit Gateway CLI
IBM Cloud® Transit Gateway コマンドラインは、 Transit Gateway サービスへのインターフェイスを提供する。 CLI を使用して、ゲートウェイおよび接続を作成して管理し、ゲートウェイに使用できるロケーションをリストできます。
開始前に
以下の手順に従って、IBM Cloud CLI プラグインとして実装されている Transit Gateway コマンド・ライン・インターフェースを使用します。
-
IBM Cloud CLI をインストールします。
-
tg-cli/tgCLI プラグインを 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_serverBeta です。--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_serverBeta です。--network-account-id- クラシック接続の作成に使用する IBM Cloudアカウント ID。 接続先のアカウントがゲートウェイのアカウントと異なる場合、
classictype とともにのみ使用されます。
--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_serverBeta のネットワークタイプにのみ適用されます。 指定がない場合、両方の接続タイプに対して、デフォルトの範囲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。 接続先のアカウントがゲートウェイのアカウントと異なる場合、
classictype とともにのみ使用されます。 このオプションは、vpcベースのネットワークタイプには適用できません。 network_id- 使用するVPCネットワークのCRN。 このオプションは、
classicベースのネットワークタイプには適用できません。 たとえば、VPCのCRNを確認するには:
ibmcloud is vpc VPC_ID --jsontunnels-
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