Transit Gateway CLI

IBM Cloud® Transit Gateway 命令行为 Transit Gateway 服务提供了一个接口。您可以使用CLI创建和管理网关和连接，并列出网关的可用位置。

准备工作

请按照以下说明使用 Transit Gateway 命令行界面，该界面以 IBM Cloud CLI插件的形式实现。

安装 IBM Cloud 命令行界面。
将 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 Gateways

本节介绍了网关功能的 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 中创建一个名为 myGateway 的网关，使用 local 路由并使用默认资源组。

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`

列出中转网关上的所有账户连接。

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 ≤ 值 ≤ 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`

在传输网关上列出连接。

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

命令选项

GATEWAY_ID: 您希望连接的网关的ID。
--all-pages （选择当前可用性）: 列出所有连接，无论是否指定了 --limit 的大小。
--limit （选择当前可用性）: 每页显示的最大资源数量。默认限制为 100。可能的值：1 ≤ 值 ≤ 500
--output json: 可选：指定是否要以JSON格式显示输出。
--help | -h: 可选：获取有关此命令的帮助。

示例

列出网关上的连接。

ibmcloud tg cs $gateway

其他命令需要连接ID。将该 ID 保存为环境变量，以便日后使用，例如：

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

`ibmcloud tg connection-create`

在传输网关上创建连接。

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 命令。

在传输网关上创建一个通用路由封装（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: 可选：如果未指定远程边界网关协议自治系统编号，则会自动生成一个。
--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）隧道或非绑定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: 可选：如果未指定远程边界网关协议自治系统编号，则会自动生成一个。
--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 类型，当连接账户与网关账户不同时。此选项不适用于 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 地址必须符合 RFC 1918 的规定，并且不是 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

可选：如果未指定远程边界网关协议自治系统编号，则会自动生成一个。

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: 可选：如果未指定远程边界网关协议自治系统编号，则会自动生成一个。
--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，连接 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7，操作 permit。

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 和连接中删除前缀过滤器 ID b4dbe0a6-c52d-4128-cc32-6f53d86bc82b 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7

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 Gateways

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`