Interface de ligne de commande de Transit Gateway

La ligne de commande IBM Cloud® Transit Gateway fournit une interface avec le service Transit Gateway. Vous pouvez utiliser cette interface pour créer et gérer les passerelles et les connexions, et répertorier les emplacements disponibles pour les passerelles.

Avant de commencer

Suivez ces instructions pour utiliser l'interface de ligne de commande de Transit Gateway, qui est implémentée en tant que plug-in d'interface de ligne de commande d'IBM Cloud.

  1. Installez l'interface de ligne de commande IBM Cloud.

  2. Installez le plug-in de l'interface de ligne de commande tg-cli/tg sur l'interface de ligne de commande IBM Cloud.

    Pour effectuer l'installation :

    ibmcloud plugin install tg
    

Si vous allez utiliser l'interface de ligne de commande avec un nœud final privé virtuel (VPE), vous devez définir la variable suivante :

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

ibmcloud plugin show tg

Afficher les informations du plug-in d'interface de ligne de commande de Transit Gateway.

ibmcloud plugin show tg

Passerelles de transit

Cette section fournit des informations sur les commandes de l'interface en ligne de commande (CLI) relatives aux fonctions de la passerelle.

ibmcloud tg gateway

Extraire les détails d'une passerelle spécifique.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle pour laquelle vous souhaitez obtenir des informations.
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Demander des détails sur la passerelle.

ibmcloud tg gw $gateway

ibmcloud tg gateways

Répertorier les passerelles Transit Gateway.

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

Options de commande

--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

D'autres commandes nécessitent un identifiant de passerelle. Enregistrez cet identifiant sous forme de variable d'environnement afin de pouvoir l'utiliser ultérieurement, par exemple :

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

ibmcloud tg gateway-create

Créer une passerelle Transit Gateway.

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]

Options de commande

--name
Nom de la nouvelle passerelle.
--location
Emplacement de la passerelle (voir les valeurs possibles sur ibmcloud tg locations)
--routing
Routage des ressources par passerelle (global | local). Sélectionnez global pour connecter les ressources entre les régions. La valeur par défaut est local.
--resource-group-id
Facultatif : ID du groupe de ressources de la passerelle. Si cette option n'est pas spécifiée, le groupe de ressources par défaut est utilisé.
--gre-enhanced-route-propagation
Optionnel : Indiquez si vous souhaitez activer la propagation des routes sur tous les GRE connectés à la même passerelle de transit. Les valeurs valides sont : true et false (par défaut).
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Créer une passerelle nommée myGateway dans us-south avec routage local et qui utilise le groupe de ressources par défaut.

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

ibmcloud tg gateway-delete

Supprimer une passerelle existante.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle que vous souhaitez supprimer.
--force | -f
Facultatif : forcer la suppression sans confirmation.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Supprimer la passerelle sans confirmation.

ibmcloud tg gwd $gateway -f

ibmcloud tg gateway-update

Mettre à jour les propriétés d'une passerelle existante.

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

Options de commande

GATEWAY_ID

Identifiant de la passerelle que vous souhaitez mettre à jour.

--name

Facultatif : nouveau nom de la passerelle.

--routing

Facultatif : routage des ressources par passerelle (global | local). Sélectionnez global pour connecter les ressources entre les régions. Pour modifier le routage de global vers local, toutes les connexions existantes doivent être redirigées vers local.

--gre-enhanced-route-propagation

Optionnel : Indiquez si vous souhaitez activer la propagation des routes sur tous les GRE connectés à la même passerelle de transit. Les valeurs valides sont : true et false (par défaut).

Après avoir modifié cette valeur, attendez quelques minutes pour que la modification prenne effet.

--output json

Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.

--help | -h

Facultatif : obtenir de l'aide sur cette commande.

Exemple

Mettez à jour la passerelle en lui attribuant une valeur de routage de global.

ibmcloud tg gwu $gateway --routing global

Connexions

Cette section fournit des informations sur les commandes de l'interface en ligne de commande (CLI) relatives aux fonctions de connexion.

ibmcloud tg acc-connections

Liste de toutes les connexions de compte sur la passerelle de transit.

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

Options de commande

--network-id

Optionnel. Pour classic, ne fixez pas de valeur. Utilisez le CRN pour tous les autres types de réseau. Par exemple, pour trouver le CRN d'un VPC :

ibmcloud is vpc VPC_ID --json
--network-type
Optionnel. Type de réseau de la connexion. Les valeurs sont classic, directlink, power_virtual_server, vpn_gateway, et vpc.
--all-pages
Facultatif : Liste toutes les connexions, que la taille de --limit soit spécifiée ou non.
--limit NUMERIC_VALUE
Facultatif : Le nombre maximum de ressources à renvoyer par page. La limite par défaut est de 50. Valeurs possibles : 1 ≤ valeur ≤ 500
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemples

Liste de toutes les connexions de compte :

ibmcloud tg acc-connections|ac

Liste des connexions de comptes filtrée par type de réseau :

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

ibmcloud tg connection

Extraire les détails d'une connexion spécifique.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle sur laquelle la connexion est établie.
CONNECTION_ID
Identifiant de la connexion pour laquelle vous souhaitez obtenir des informations.
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Demander des détails sur un ID de connexion spécifique.

ibmcloud tg c $gateway $connection

ibmcloud tg connections

Répertorier les connexions sur la passerelle de transit.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle pour laquelle vous souhaitez établir des connexions.
--all-pages (Disponibilité à confirmer)
Répertorie toutes les connexions, qu'une taille d' --limit s soit spécifiée ou non.
--limit (Disponibilité à confirmer)
Le nombre maximum de ressources à renvoyer par page. La limite par défaut est de 100. Valeurs possibles : 1 ≤ valeur ≤ 500
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Répertorier les connexions sur la passerelle.

ibmcloud tg cs $gateway

D'autres commandes nécessitent un identifiant de connexion. Enregistrez cet identifiant sous forme de variable d'environnement afin de pouvoir l'utiliser ultérieurement, par exemple :

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

ibmcloud tg connection-create

Créer une connexion sur la passerelle de transit.

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]

Options de commande

GATEWAY_ID
Identifiant de la passerelle sur laquelle se trouve la nouvelle connexion.
--name
Nom de la nouvelle connexion.
--network-id
Identifiant de la connexion réseau. Pour classic, ne fixez pas de valeur. Utilisez le CRN pour tous les autres types de réseau. Par exemple, pour trouver le CRN d'un VPC :
ibmcloud is vpc VPC_ID --json
--network-type
Type de réseau de la connexion. Les valeurs sont classic, directlink, power_virtual_server, vpn_gateway, et vpc.
--network-account-id
Identifiant du compte « IBM Cloud » à utiliser pour créer une connexion classique. À utiliser uniquement avec le type « classic », lorsque le compte de la connexion est différent de celui de la passerelle.
--zone
Facultatif : zone de disponibilité dans laquelle un tunnel GRE ou une connexion VPN sera déployé(e). Uniquement applicable au type de réseau vpn_gateway.
--default-prefix-filter
Facultatif : filtre de préfixe par défaut de la connexion (permit | deny).
--cidr
Facultatif : bloc CIDR à utiliser pour la connexion. Uniquement applicable au type de réseau vpn_gateway.
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Créer une connexion VPC nommée vpc-connection et utilisant 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

Créez une connexion classique nommée classic-conn.

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

ibmcloud tg connection-delete

Supprimer une connexion existante.

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

Options de commande

GATEWAY_ID
ID de la passerelle de la connexion qui est supprimée.
CONNECTION_ID
ID de la connexion en cours de suppression.
--force | -f
Facultatif : forcer la suppression sans confirmation.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Supprimer la connexion sans confirmation.

ibmcloud tg cd $gateway $connection -f

ibmcloud tg connection-create-gre (Déprécié)

Cette commande est obsolète. Utilisez la commande tg-connection-gre-create.

Créez une connexion par tunnel GRE (Generic Routing Encapsulation) sur la passerelle de transit.

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]

Options de commande

GATEWAY_ID Identifiant de la passerelle à laquelle la nouvelle connexion est associée.

--name
Nom de la nouvelle connexion GRE.
--zone
Zone de disponibilité pour le tunnel GRE. Exemple:us-south-1
--local-gateway-ip
Adresse IP de la passerelle locale pour la connexion via le tunnel GRE.
--local-tunnel-ip
Adresse IP locale du tunnel pour la connexion via le tunnel GRE.
--remote-gateway-ip
Adresse IP de la passerelle distante pour la connexion via le tunnel GRE.
--remote-tunnel-ip
Adresse IP du tunnel distant pour la connexion via le tunnel GRE.
--base-connection-id
Facultatif : identifiant de la connexion réseau classique servant de sous-couche au tunnel GRE. Cette option est à utiliser uniquement avec le type de réseau « gre_tunnel ».
--base-network-type
Type de réseau de la connexion de base (classic).
--network-type
Facultatif : type de réseau de la connexion GRE. La valeur par défaut est gre_tunnel.
--network-account-id
Facultatif : ID du compte à connecter à une connexion classique. À utiliser uniquement avec le type « classic » lorsque le compte de la connexion est différent de celui de la passerelle.
--remote-bgp-asn
Facultatif : si l'ASN BGP distant n'est pas spécifié, un ASN est généré.
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemples

Créez une connexion tunnel GRE nommée « gre-connection » et utilisant la connexion classique « 9037f710-8dfb-4948-a2bd-847c8dde96d3 » comme connexion de 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

Approuver une connexion depuis un autre compte en tant que propriétaire de réseau.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle sur laquelle la connexion est établie.
CONNECTION_ID
Identifiant de la connexion que vous approuvez.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Approuver une demande de connexion.

ibmcloud tg ca $gateway $connection

ibmcloud tg connection-gre-create

Créer un tunnel GRE (Generic Routing Encapsulation) ou une connexion GRE non liée sur la passerelle de transit.

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]

Options de commande

GATEWAY_ID
Identifiant de la passerelle à laquelle la nouvelle connexion est associée.
--name
Nom de la nouvelle connexion GRE.
--zone
Zone de disponibilité pour le tunnel GRE. Exemple:us-south-1
--local-gateway-ip
Adresse IP de la passerelle locale pour la connexion via le tunnel GRE.
--local-tunnel-ip
Adresse IP locale du tunnel pour la connexion via le tunnel GRE.
--remote-gateway-ip
Adresse IP de la passerelle distante pour la connexion via le tunnel GRE.
--remote-tunnel-ip
Adresse IP du tunnel distant pour la connexion via le tunnel GRE.
--base-connection-id
Facultatif : identifiant de la connexion réseau classique servant de sous-couche au tunnel GRE. Cette option est à utiliser uniquement avec le type de réseau « gre_tunnel ».
--base-network-type
Facultatif : type de réseau de la connexion de base (classic).
--network-type
Facultatif : type de réseau de la connexion GRE. Les valeurs sont gre_tunnel ou unbound_gre_tunnel. La valeur par défaut est gre_tunnel.
--network-account-id
Facultatif : ID du compte à connecter à une connexion classique. À utiliser uniquement avec le type « classic » lorsque le compte de la connexion est différent de celui de la passerelle.
--remote-bgp-asn
Facultatif : si l'ASN BGP distant n'est pas spécifié, un ASN est généré.
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemples

Créez une connexion tunnel GRE nommée « gre-connection » et utilisant la connexion classique « 9037f710-8dfb-4948-a2bd-847c8dde96d3 » comme connexion de 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

Rejeter une connexion depuis un autre compte en tant que propriétaire de réseau.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle sur laquelle la connexion est établie.
CONNECTION_ID
Identifiant de la connexion que vous refusez.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Rejeter une demande de connexion.

ibmcloud tg cr $gateway $connection

ibmcloud tg connection-rgre-create

Créer une connexion GRE redondante sur la passerelle de transit.

Vous devez utiliser un fichier JSON comme entrée.

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

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

Options de commande

gateway_id
ID de la passerelle sur laquelle se trouve la nouvelle connexion GRE redondante.
name
Nom de la nouvelle connexion GRE redondante.
network_type
Type de réseau de la connexion. La valeur est l redundant_gre.

base_network_type Le type de réseau à utiliser. Les options sont classic et vpc.

network_account_id
ID du compte d' IBM Cloud s à utiliser pour un réseau classique inter-comptes. À utiliser uniquement avec le type « classic », lorsque le compte de la connexion est différent de celui de la passerelle. Cette option n'est pas valide pour le type de réseau de base « vpc ».
network_id
Le CRN du réseau VPC à utiliser. Cette option n'est pas valide pour le type de réseau de base « classic ». Par exemple, pour trouver le CRN d'un VPC :
ibmcloud is vpc VPC_ID --json
tunnels

Informations pour les tunnels GRE.

local_gateway_ip

Adresse IP de la passerelle locale pour la connexion via le tunnel GRE. Ce champ est obligatoire pour les connexions de type réseau ( redundant_gre ).

Lors de l'utilisation d'un type de réseau de base vpc, cette adresse IP doit être conforme à la RFC 1918 et ne pas être une adresse IP dans la plage de multidiffusion de 224.0.0.0 à 239.255.255.255 et ne peut pas être en conflit avec les réseaux existants qui sont connectés à la passerelle de transit. De plus, cette adresse IP ne peut pas être utilisée comme local-gateway-ip pour un autre GRE utilisant le même réseau sous-jacent.

local_tunnel_ip

Adresse IP locale du tunnel attribuée au côté « Transit Gateway » du tunnel. Les adresses local_tunnel_ip et remote_tunnel_ip doivent appartenir au même réseau /30. Il ne peut pas être non plus le réseau ou les adresses de diffusion. Ce champ est obligatoire pour les connexions de type réseau ( redundant_gre ).

name

Nom du tunnel GRE.

remote_bgp_asn

Facultatif : si l'ASN BGP distant n'est pas spécifié, un ASN est généré.

remote_gateway_ip

Adresse IP de la passerelle distante pour la connexion via le tunnel GRE.

remote_tunnel_ip

Adresse IP du tunnel distant pour la connexion via le tunnel GRE.

zone

Zone de disponibilité pour le tunnel GRE. Exemple:us-south-1

ibmcloud tg connection-update

Mettre à jour les propriétés d'une connexion existante.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle sur laquelle la connexion est en cours de mise à jour.
CONNECTION_ID
Identifiant de la connexion à mettre à jour.
--name
Nouveau nom de la connexion.
--default-prefix-filter
Facultatif : filtre de préfixe par défaut de la connexion (permit | deny).
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Remplacer le nom de la connexion par MyConn2.

ibmcloud tg cu $gateway $connection --name MyConn2

ibmcloud tg redundant-gre-tunnel-add

Ajouter un tunnel à un GRE redondant.

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]

Options de commande

GATEWAY_ID
Identifiant de la passerelle à laquelle la nouvelle connexion est associée.
REDUNDANT_GRE_ID
ID de la connexion GRE redondante.
--name
Nom du nouveau tunnel GRE.
--zone
Zone de disponibilité pour le tunnel GRE. Exemple:us-south-1
--local-gateway-ip
Adresse IP de la passerelle locale pour la connexion via le tunnel GRE.
--local-tunnel-ip
Adresse IP locale du tunnel pour la connexion via le tunnel GRE.
--remote-gateway-ip
Adresse IP de la passerelle distante pour la connexion via le tunnel GRE.
--remote-tunnel-ip
Adresse IP du tunnel distant pour la connexion via le tunnel GRE.
--remote-bgp-asn
Facultatif : si l'ASN BGP distant n'est pas spécifié, un ASN est généré.
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

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

Supprimer un tunnel d'un GRE redondant.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle à laquelle la nouvelle connexion est associée.
REDUNDANT_GRE_ID
ID de la connexion GRE redondante.
TUNNEL_ID
Identifiant du tunnel à supprimer.
--force | -f
Facultatif : forcer la suppression sans confirmation.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

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

ibmcloud tg tunnels

Répertoriez tous les tunnels sous un GRE redondant donné.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle à laquelle la nouvelle connexion est associée.
REDUNDANT_GRE_ID
ID de la connexion GRE redondante.
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--force | -f
Facultatif : forcer la suppression sans confirmation.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

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

Emplacements

Cette section fournit des informations sur les commandes CLI relatives aux fonctions de localisation.

ibmcloud tg locations

Utilisez cette commande pour répertorier les emplacements possibles pour la création d'une passerelle.

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

Options de commande

--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

ibmcloud tg location

Extraire des informations spécifiques sur l'emplacement.

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

Options de commande

NAME
Nom du lieu sur lequel vous souhaitez obtenir des informations.
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Demander des détails sur l'emplacement us-south.

ibmcloud tg location us-south

Filtres de préfixe de connexion

Cette section fournit des informations sur les commandes CLI pour les fonctions de filtrage des préfixes de connexion.

ibmcloud tg prefix-filter-create

Ajouter un filtre de préfixe à la connexion.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle à laquelle le filtre de préfixe est appliqué.
CONNECTION_ID
Identifiant de la connexion à laquelle le filtre de préfixe est appliqué.
--prefix
Préfixe de réseau auquel le filtre est appliqué.
--action
Action à effectuer sur le préfixe indiqué (permit | deny).
--le
Facultatif : filtre de préfixe appliqué à un masque de sous-réseau inférieur ou égal à cette valeur.
--ge
Facultatif : filtre de préfixe appliqué à un masque de sous-réseau supérieur ou égal à cette valeur.
--before
Facultatif : identifiant du filtre de préfixe auquel ce filtre doit être appliqué en amont. S'il est vide, ce filtre est appliqué en dernier.
--output
Facultatif : spécifiez le format de sortie; seul le format « json » est pris en charge. Tous les détails sont affichés.
Exemples

Ajoutez un filtre de préfixe pour 10.0.250.0/24 à la passerelle 9f559c43-63f4-4da5-b312-b525a8dce185, connexion 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7 avec l'action 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

Supprimer le filtre de préfixe de la connexion.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle à partir de laquelle le filtre de préfixe est supprimé.
CONNECTION_ID
Identifiant de la connexion de laquelle le filtre de préfixe a été supprimé.
FILTER_ID
Identifiant du filtre de préfixe en cours de suppression.
--force, -f
Forcer l'opération de suppression sans confirmation.
Exemples

Supprimer l'ID de filtre de préfixe b4dbe0a6-c52d-4128-cc32-6f53d86bc82b de la passerelle 9f559c43-63f4-4da5-b312-b525a8dce185 et de la connexion 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7

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

Rapports de route

Cette section fournit des informations sur les commandes CLI relatives aux fonctions de rapport de routage.

ibmcloud tg route-reports

Cette commande permet de répertorier les rapports de route disponibles sur une passerelle.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle pour laquelle afficher les rapports de routage.
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Répertorier les rapports de route sur la passerelle.

ibmcloud tg rrs $gateway

D'autres commandes nécessitent un identifiant de rapport de route. Enregistrez cet identifiant sous forme de variable d'environnement afin de pouvoir l'utiliser ultérieurement, par exemple :

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

ibmcloud tg route-report

Extraire les détails d'un rapport de route spécifique.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle d'où provient le rapport de routage.
REPORT_ID
Identifiant du rapport d'itinéraire pour lequel vous souhaitez obtenir des détails.
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Demander les détails d'un rapport de route.

ibmcloud tg rr $gateway $report

ibmcloud tg route-report-create

Créer un rapport de route.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle pour laquelle le rapport de routage est généré.
--output json
Facultatif : indiquez si vous souhaitez que le résultat s'affiche au format JSON.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Créer un rapport de route pour une passerelle.

ibmcloud tg rrc $gateway

ibmcloud tg route-report-delete

Supprimer un rapport de route existant.

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

Options de commande

GATEWAY_ID
Identifiant de la passerelle concernée par le rapport.
REPORT_ID
Identifiant du rapport que vous souhaitez supprimer.
--force | -f
Facultatif : forcer la suppression sans confirmation.
--help | -h
Facultatif : obtenir de l'aide sur cette commande.

Exemple

Supprimer le rapport de route sans confirmation.

ibmcloud tg rrd $gateway $report -f