Transit Gateway CLI

La riga di comando IBM Cloud® Transit Gateway fornisce un'interfaccia con il servizio Transit Gateway. È possibile utilizzare la CLI per creare e gestire gateway e connessioni ed elencare le posizioni disponibili per i gateway.

Prima di iniziare

Segui queste istruzioni per utilizzare l'interfaccia a riga di comando di Transit Gateway, implementata come plug-in CLI di IBM Cloud.

Installare l' IBM Cloud e CLI.
Installare il plug-in CLI " tg-cli/tg " nella CLI " IBM Cloud ".

Per eseguire l'installazione:
```
ibmcloud plugin install tg
```

Se si intende utilizzare la CLI con un Virtual Private Endpoint (VPE), è necessario impostare la seguente variabile:

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

`ibmcloud plugin show tg`

Mostra le informazioni sul plug-in CLI Transit Gateway.

ibmcloud plugin show tg

Gateway di transito

Questa sezione fornisce informazioni sui comandi CLI relativi alle funzioni del gateway.

`ibmcloud tg gateway`

Recuperare i dettagli su un gateway specifico.

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

Opzioni comando

GATEWAY_ID: ID del gateway per il quale si desiderano i dettagli.
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Richiedi i dettagli per il gateway.

ibmcloud tg gw $gateway

`ibmcloud tg gateways`

Elencare i gateway di transito.

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

Opzioni comando

--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Altri comandi richiedono un ID gateway. Salva l'ID come variabile di ambiente in modo da poterlo utilizzare in seguito, ad esempio:

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

`ibmcloud tg gateway-create`

Creare un gateway di transito.

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]

Opzioni comando

--name: Nome per il nuovo gateway.
--location: Posizione del gateway (vedere i valori possibili all'indirizzo ibmcloud tg locations)
--routing: Gateway routing of resources (global | local). Selezionare global per collegare le risorse tra le regioni. Il valore predefinito è local.
--resource-group-id: Opzionale: ID gruppo risorse gateway. Utilizza il gruppo di risorse predefinito, se non specificato.
--gre-enhanced-route-propagation: Opzionale: Specificare se si desidera abilitare la propagazione del percorso in tutti i GRE collegati allo stesso gateway di transito. I valori validi sono true e false (impostazione predefinita).
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Creare un gateway denominato myGateway in us-south con routing local e che utilizzi il gruppo di risorse predefinito.

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

`ibmcloud tg gateway-delete`

Eliminare un gateway esistente.

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

Opzioni comando

GATEWAY_ID: ID del gateway che si desidera eliminare.
--force | -f: Opzionale: forza l'eliminazione senza conferma.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Eliminare il gateway senza conferma.

ibmcloud tg gwd $gateway -f

`ibmcloud tg gateway-update`

Aggiorna le proprietà su un gateway esistente.

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

Opzioni comando

GATEWAY_ID

ID del gateway che si desidera aggiornare.

--name

Opzionale: nuovo nome del gateway.

--routing

Opzionale: instradamento gateway delle risorse (global | local). Selezionare globale per connettere le risorse tra le regioni. Per cambiare il routing da global a local è necessario che tutte le connessioni esistenti siano local.

--gre-enhanced-route-propagation

Opzionale: Specificare se si desidera abilitare la propagazione del percorso in tutti i GRE collegati allo stesso gateway di transito. I valori validi sono true e false (impostazione predefinita).

Dopo aver modificato questo valore, attendere qualche minuto affinché la modifica abbia effetto.

--output json

Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.

--help | -h

Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Aggiorna il gateway con un valore di routing di global.

ibmcloud tg gwu $gateway --routing global

Connessioni

Questa sezione fornisce informazioni sui comandi CLI relativi alle funzioni di connessione.

`ibmcloud tg acc-connections`

Elenca tutte le connessioni dell'account sul gateway di transito.

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

Opzioni comando

--network-id

Facoltativo. Per classic, non impostare un valore. Utilizzare il CRN per tutti gli altri tipi di rete. Ad esempio, per trovare il CRN di un VPC:

ibmcloud is vpc VPC_ID --json

--network-type: Facoltativo. Tipo di rete della connessione. I valori sono classic, directlink, power_virtual_server, vpn_gateway e vpc.
--all-pages: Opzionale: Elenca tutte le connessioni indipendentemente dal fatto che sia specificata una dimensione --limit.
--limit NUMERIC_VALUE: Opzionale: Il numero massimo di risorse da restituire per pagina. Il limite predefinito è 50. Valori possibili: 1 ≤ valore ≤ 500
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempi

Elenca tutte le connessioni dell'account:

ibmcloud tg acc-connections|ac

Elenco delle connessioni dell'account filtrate per tipo di rete:

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

`ibmcloud tg connection`

Recupera i dettagli relativi a una connessione specifica.

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

Opzioni comando

GATEWAY_ID: ID del gateway su cui è attiva la connessione.
CONNECTION_ID: ID della connessione di cui si desiderano i dettagli.
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Richiedi i dettagli per un ID di connessione specifico.

ibmcloud tg c $gateway $connection

`ibmcloud tg connections`

Elencare le connessioni sul gateway di transito.

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

Opzioni comando

GATEWAY_ID: ID del gateway per il quale si desiderano le connessioni.
--all-pages (Seleziona la disponibilità in questo momento): Elenca tutti i collegamenti indipendentemente dal fatto che sia specificata una dimensione dell' --limit e.
--limit (Seleziona la disponibilità in questo momento): Il numero massimo di risorse da restituire per pagina. Il limite predefinito è 100. Valori possibili: 1 ≤ valore ≤ 500
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Elencare le connessioni sul gateway.

ibmcloud tg cs $gateway

Altri comandi richiedono un ID di connessione. Salva l'ID come variabile di ambiente in modo da poterlo utilizzare in seguito, ad esempio:

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

`ibmcloud tg connection-create`

Creare una connessione sul gateway di transito.

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]

Opzioni comando

GATEWAY_ID: ID del gateway su cui si trova la nuova connessione.
--name: Nome per la nuova connessione.
--network-id: ID della connessione di rete. Per classic, non impostare un valore. Utilizzare il CRN per tutti gli altri tipi di rete. Ad esempio, per trovare il CRN di un VPC:

ibmcloud is vpc VPC_ID --json

--network-type: Tipo di rete della connessione. I valori sono classic, directlink, power_virtual_server, vpn_gateway e vpc.
--network-account-id: ID dell'account IBM Cloud da utilizzare per creare una connessione classica. Utilizzato solo con il tipo " classic ", quando l'account della connessione è diverso dall'account del gateway.
--zone: Facoltativo: zona di disponibilità in cui verrà implementato un tunnel GRE o una connessione VPN. Si applica solo al tipo di rete vpn_gateway.
--default-prefix-filter: Opzionale: filtro del prefisso predefinito della connessione (permit | deny).
--cidr: Facoltativo: blocco CIDR da utilizzare per la connessione. Si applica solo al tipo di rete vpn_gateway.
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Creare una connessione VPC denominata vpc-connection e che utilizza 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

Creare una connessione Classic denominata classic-conn.

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

`ibmcloud tg connection-delete`

Eliminare una connessione esistente.

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

Opzioni comando

GATEWAY_ID: ID del gateway della connessione che viene eliminata.
CONNECTION_ID: ID della connessione che viene eliminata.
--force | -f: Opzionale: forza l'eliminazione senza conferma.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Elimina connessione senza conferma.

ibmcloud tg cd $gateway $connection -f

`ibmcloud tg connection-create-gre` (obsoleto)

Questo comando è obsoleto. Utilizzare il comando tg-connection-gre-create.

Creare una connessione tunnel GRE (Generic Routing Encapsulation) sul gateway di transito.

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]

Opzioni comando

GATEWAY_ID ID del gateway a cui è associata la nuova connessione.

--name: Nome della nuova connessione GRE.
--zone: Zona di disponibilità per il tunnel GRE. Esempio: us-south-1
--local-gateway-ip: Indirizzo IP gateway locale per la connessione tunnel GRE.
--local-tunnel-ip: Indirizzo IP locale del tunnel per la connessione GRE.
--remote-gateway-ip: Indirizzo IP del gateway remoto per la connessione del tunnel GRE.
--remote-tunnel-ip: Indirizzo IP del tunnel remoto per la connessione del tunnel GRE.
--base-connection-id: Opzionale: ID della connessione di rete classica che è il sottostrato per il tunnel GRE. Questa opzione è utilizzabile solo con il tipo di rete gre_tunnel.
--base-network-type: Tipo di rete della connessione di base (classic).
--network-type: Opzionale: tipo di rete della connessione GRE. Il valore predefinito è gre_tunnel.
--network-account-id: Opzionale: ID dell'account per collegarsi a una connessione classica. Utilizzare solo con un tipo di gateway ( classic ) quando l'account della connessione è diverso dall'account del gateway.
--remote-bgp-asn: Opzionale: se l'ASN BGP remoto non è specificato, ne viene generato uno.
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempi

Creare una connessione GRE tunnel denominata " gre-connection " e utilizzare la connessione classica " 9037f710-8dfb-4948-a2bd-847c8dde96d3 " come connessione di base.

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`

Approvare una connessione da un altro account come proprietario della rete.

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

Opzioni comando

GATEWAY_ID: ID del gateway su cui è attiva la connessione.
CONNECTION_ID: ID della connessione che stai approvando.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Approvare la richiesta di connessione.

ibmcloud tg ca $gateway $connection

`ibmcloud tg connection-gre-create`

Creare un tunnel GRE (Generic Routing Encapsulation) o una connessione GRE non associata sul gateway di transito.

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]

Opzioni comando

GATEWAY_ID: ID del gateway a cui è collegata la nuova connessione.
--name: Nome della nuova connessione GRE.
--zone: Zona di disponibilità per il tunnel GRE. Esempio: us-south-1
--local-gateway-ip: Indirizzo IP gateway locale per la connessione tunnel GRE.
--local-tunnel-ip: Indirizzo IP locale del tunnel per la connessione GRE.
--remote-gateway-ip: Indirizzo IP del gateway remoto per la connessione del tunnel GRE.
--remote-tunnel-ip: Indirizzo IP del tunnel remoto per la connessione del tunnel GRE.
--base-connection-id: Opzionale: ID della connessione di rete classica che è il sottostrato per il tunnel GRE. Questa opzione è utilizzabile solo con il tipo di rete gre_tunnel.
--base-network-type: Facoltativo: tipo di rete della connessione di base (classic).
--network-type: Opzionale: tipo di rete della connessione GRE. I valori sono gre_tunnel o unbound_gre_tunnel. Il valore predefinito è gre_tunnel.
--network-account-id: Opzionale: ID dell'account per collegarsi a una connessione classica. Utilizzare solo con un tipo di gateway ( classic ) quando l'account della connessione è diverso dall'account del gateway.
--remote-bgp-asn: Opzionale: se l'ASN BGP remoto non è specificato, ne viene generato uno.
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempi

Creare una connessione GRE tunnel denominata " gre-connection " e utilizzare la connessione classica " 9037f710-8dfb-4948-a2bd-847c8dde96d3 " come connessione di base.

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`

Rifiuta una connessione da un altro account come proprietario della rete.

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

Opzioni comando

GATEWAY_ID: ID del gateway su cui è attiva la connessione.
CONNECTION_ID: ID della connessione che stai rifiutando.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Rifiuta la richiesta di connessione.

ibmcloud tg cr $gateway $connection

`ibmcloud tg connection-rgre-create`

Creare una connessione GRE ridondante sul gateway di transito.

È necessario utilizzare un file JSON come input.

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

File 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"
          }
       }
    ]
}

Opzioni comando

gateway_id: ID del gateway su cui si trova la nuova connessione GRE ridondante.
name: Nome della nuova connessione GRE ridondante.
network_type: Tipo di rete della connessione. Il valore è redundant_gre.

base_network_type Il tipo di rete da utilizzare. Le opzioni sono classic e vpc.

network_account_id: ID dell'account IBM Cloud da utilizzare per una rete classica tra account. Utilizzato solo con il tipo " classic ", quando l'account della connessione è diverso dall'account del gateway. Questa opzione non è valida per il tipo di rete base dell' vpc.
network_id: Il CRN della rete VPC da utilizzare. Questa opzione non è valida per il tipo di rete base dell' classic. Ad esempio, per trovare il CRN di un VPC:

ibmcloud is vpc VPC_ID --json

tunnels

Informazioni per le gallerie GRE.

local_gateway_ip

Indirizzo IP gateway locale per la connessione tunnel GRE. Questo campo è obbligatorio per le connessioni di tipo rete redundant_gre.

Quando si utilizza un tipo di rete di base vpc, questo indirizzo IP deve essere conforme all'RFC 1918 e non deve essere un indirizzo IP all'interno dell'intervallo multicast di 224.0.0.0 a 239.255.255.255 e non può essere in conflitto con eventuali reti esistenti collegate al gateway di transito. Inoltre, questo indirizzo IP non può essere utilizzato come local-gateway-ip per un altro GRE che utilizza la stessa rete underlay.

local_tunnel_ip

Indirizzo IP locale del tunnel assegnato al lato dell' Transit Gateway e del tunnel. Gli indirizzi local_tunnel_ip e remote_tunnel_ip devono trovarsi nella stessa rete di /30. Né può essere la rete né gli indirizzi di trasmissione. Questo campo è obbligatorio per le connessioni di tipo rete redundant_gre.

name

Nome del tunnel GRE.

remote_bgp_asn

Opzionale: se l'ASN BGP remoto non è specificato, ne viene generato uno.

remote_gateway_ip

Indirizzo IP del gateway remoto per la connessione del tunnel GRE.

remote_tunnel_ip

Indirizzo IP del tunnel remoto per la connessione del tunnel GRE.

zone

Zona di disponibilità per il tunnel GRE. Esempio: us-south-1

`ibmcloud tg connection-update`

Aggiorna le proprietà di una connessione esistente.

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

Opzioni comando

GATEWAY_ID: ID del gateway su cui è in corso l'aggiornamento della connessione.
CONNECTION_ID: ID della connessione da aggiornare.
--name: Nuovo nome della connessione.
--default-prefix-filter: Opzionale: filtro del prefisso predefinito della connessione (permit | deny).
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Aggiornare il nome della connessione a MyConn2.

ibmcloud tg cu $gateway $connection --name MyConn2

`ibmcloud tg redundant-gre-tunnel-add`

Aggiungere un tunnel a un GRE ridondante.

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]

Opzioni comando

GATEWAY_ID: ID del gateway a cui è collegata la nuova connessione.
REDUNDANT_GRE_ID: ID della connessione GRE ridondante.
--name: Nome del nuovo tunnel GRE.
--zone: Zona di disponibilità per il tunnel GRE. Esempio: us-south-1
--local-gateway-ip: Indirizzo IP gateway locale per la connessione tunnel GRE.
--local-tunnel-ip: Indirizzo IP locale del tunnel per la connessione GRE.
--remote-gateway-ip: Indirizzo IP del gateway remoto per la connessione del tunnel GRE.
--remote-tunnel-ip: Indirizzo IP del tunnel remoto per la connessione del tunnel GRE.
--remote-bgp-asn: Opzionale: se l'ASN BGP remoto non è specificato, ne viene generato uno.
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

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`

Rimuovere un tunnel da un GRE ridondante.

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

Opzioni comando

GATEWAY_ID: ID del gateway a cui è collegata la nuova connessione.
REDUNDANT_GRE_ID: ID della connessione GRE ridondante.
TUNNEL_ID: ID del tunnel da eliminare.
--force | -f: Opzionale: forza l'eliminazione senza conferma.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

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

`ibmcloud tg tunnels`

Elenca tutte le gallerie sotto un determinato GRE ridondante.

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

Opzioni comando

GATEWAY_ID: ID del gateway a cui è collegata la nuova connessione.
REDUNDANT_GRE_ID: ID della connessione GRE ridondante.
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--force | -f: Opzionale: forza l'eliminazione senza conferma.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

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

Ubicazioni

Questa sezione fornisce informazioni sui comandi CLI relativi alle funzioni di localizzazione.

`ibmcloud tg locations`

Utilizzare questo comando per elencare le possibili posizioni per creare un gateway.

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

Opzioni comando

--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

`ibmcloud tg location`

Recupera informazioni specifiche per questa posizione.

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

Opzioni comando

NAME: Nome della località per la quale desideri informazioni.
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Richiedi dettagli per la localizzazione us-south.

ibmcloud tg location us-south

Filtri di connessione

Questa sezione fornisce informazioni sui comandi CLI per le funzioni di filtro del prefisso di connessione.

`ibmcloud tg prefix-filter-create`

Aggiungere il prefisso filtro alla connessione.

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

Opzioni comando

GATEWAY_ID: ID del gateway a cui viene applicato il filtro prefisso.
CONNECTION_ID: ID della connessione a cui viene applicato il filtro prefisso.
--prefix: Prefisso di rete a cui è applicato il filtro.
--action: Azione da eseguire sul prefisso specificato (permit | deny).
--le: Opzionale: filtro prefisso che viene applicato a una subnet mask inferiore o uguale a questo valore.
--ge: Opzionale: filtro prefisso che viene applicato a una subnet mask maggiore o uguale a questo valore.
--before: Facoltativo: identificatore del filtro prefisso a cui questo filtro deve essere applicato prima. Se lasciato vuoto, questo filtro viene applicato per ultimo.
--output: Opzionale: specificare il formato di output; è supportato solo il formato " json ". Vengono visualizzati tutti i dettagli.

Esempi

Aggiungere il prefisso filter for 10.0.250.0/24 al gateway 9f559c43-63f4-4da5-b312-b525a8dce185, connessione 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7 con l'azione 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`

Eliminare il prefisso del filtro dalla connessione.

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

Opzioni comando

GATEWAY_ID: ID del gateway da cui viene eliminato il filtro del prefisso.
CONNECTION_ID: ID della connessione da cui viene eliminato il filtro prefisso.
FILTER_ID: ID del prefiltro che viene eliminato.
--force, -f: Esegui l'operazione di eliminazione senza richiesta di conferma.

Esempi

Elimina il prefisso ID filtro b4dbe0a6-c52d-4128-cc32-6f53d86bc82b dal gateway 9f559c43-63f4-4da5-b312-b525a8dce185 e dalla connessione 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7

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

Rapporti sull'instradamento

Questa sezione fornisce informazioni sui comandi CLI per le funzioni di report di percorso.

`ibmcloud tg route-reports`

Utilizzare questo comando per elencare i rapporti di percorso disponibili su un gateway.

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

Opzioni comando

GATEWAY_ID: ID del gateway per cui elencare i rapporti di percorso.
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Elenca i rapporti di percorso sul gateway.

ibmcloud tg rrs $gateway

Altri comandi richiedono un ID del rapporto di percorso. Salva l'ID come variabile di ambiente in modo da poterlo utilizzare in seguito, ad esempio:

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

`ibmcloud tg route-report`

Recuperare i dettagli relativi a un rapporto di percorso specifico.

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

Opzioni comando

GATEWAY_ID: ID del gateway da cui proviene il rapporto di percorso.
REPORT_ID: ID del rapporto sul percorso di cui si desiderano i dettagli.
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Richiedi i dettagli per un rapporto sul percorso.

ibmcloud tg rr $gateway $report

`ibmcloud tg route-report-create`

Creare un rapporto di percorso.

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

Opzioni comando

GATEWAY_ID: ID del gateway per il quale viene creato il rapporto di percorso.
--output json: Opzionale: specificare se si desidera che l'output venga visualizzato in formato JSON.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Creare un rapporto di percorso per un gateway.

ibmcloud tg rrc $gateway

`ibmcloud tg route-report-delete`

Eliminare un rapporto di percorso esistente.

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

Opzioni comando

GATEWAY_ID: ID del gateway a cui si riferisce il report.
REPORT_ID: ID del report che si desidera eliminare.
--force | -f: Opzionale: forza l'eliminazione senza conferma.
--help | -h: Facoltativo: visualizza le istruzioni relative a questo comando.

Esempio

Elimina rapporto percorso senza conferma.

ibmcloud tg rrd $gateway $report -f

Transit Gateway CLI

Transit Gateway CLI

Prima di iniziare

ibmcloud plugin show tg

Gateway di transito

ibmcloud tg gateway

Opzioni comando

Esempio

ibmcloud tg gateways

Opzioni comando

ibmcloud tg gateway-create

Opzioni comando

Esempio

ibmcloud tg gateway-delete

Opzioni comando

Esempio

ibmcloud tg gateway-update

Opzioni comando

Esempio

Connessioni

ibmcloud tg acc-connections

Opzioni comando

Esempi

ibmcloud tg connection

Opzioni comando

Esempio

ibmcloud tg connections

Opzioni comando

Esempio

ibmcloud tg connection-create

Opzioni comando

Esempio

ibmcloud tg connection-delete

Opzioni comando

Esempio

ibmcloud tg connection-create-gre (obsoleto)

Opzioni comando

Esempi

ibmcloud tg connection-approve

Opzioni comando

Esempio

ibmcloud tg connection-gre-create

Opzioni comando

Esempi

ibmcloud tg connection-reject

Opzioni comando

Esempio

ibmcloud tg connection-rgre-create

File JSON

Opzioni comando

ibmcloud tg connection-update

Opzioni comando

Esempio

ibmcloud tg redundant-gre-tunnel-add

Opzioni comando

Esempio

ibmcloud tg redundant-gre-tunnel-remove

Opzioni comando

Esempio

ibmcloud tg tunnels

Opzioni comando

Esempio

Ubicazioni

ibmcloud tg locations

Opzioni comando

ibmcloud tg location

Opzioni comando

Esempio

Filtri di connessione

ibmcloud tg prefix-filter-create

Opzioni comando

Esempi

ibmcloud tg prefix-filter-delete

Opzioni comando

Esempi

Rapporti sull'instradamento

ibmcloud tg route-reports

Opzioni comando

Esempio

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` (obsoleto)

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