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.
-
Installez l'interface de ligne de commande IBM Cloud.
-
Installez le plug-in de l'interface de ligne de commande
tg-cli/tgsur 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électionnezglobalpour connecter les ressources entre les régions. La valeur par défaut estlocal. --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 :
trueetfalse(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 deglobalverslocal, toutes les connexions existantes doivent être redirigées verslocal. --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 :
trueetfalse(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, etvpc. --all-pages- Facultatif : Liste toutes les connexions, que la taille de
--limitsoit 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|acListe 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_serveribmcloud tg connectionExtraire 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 $connectionibmcloud tg connectionsRé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'
--limits 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 $gatewayD'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-createCré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, etvpc. --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-connectionet utilisantvpcCRN="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 vpcCréez une connexion classique nommée
classic-conn.ibmcloud tg cc $gateway --name classic-conn --network-type classicibmcloud tg connection-deleteSupprimer 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 -fibmcloud 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_IDIdentifiant 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.2ibmcloud tg connection-approveApprouver 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 $connectionibmcloud tg connection-gre-createCré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_tunnelouunbound_gre_tunnel. La valeur par défaut estgre_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.2ibmcloud tg connection-rejectRejeter 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 $connectionibmcloud tg connection-rgre-createCré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_typeLe type de réseau à utiliser. Les options sontclassicetvpc.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 --jsontunnels-
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 de224.0.0.0à239.255.255.255et 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 commelocal-gateway-ippour 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_ipetremote_tunnel_ipdoivent 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-updateMettre à 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 MyConn2ibmcloud tg redundant-gre-tunnel-addAjouter 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.1ibmcloud tg redundant-gre-tunnel-removeSupprimer 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-f6df36dea08fibmcloud tg tunnelsRé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-61e8088b53c7Emplacements
Cette section fournit des informations sur les commandes CLI relatives aux fonctions de localisation.
ibmcloud tg locationsUtilisez 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 locationExtraire 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-southFiltres 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-createAjouter 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 passerelle9f559c43-63f4-4da5-b312-b525a8dce185, connexion6c1bdc19-4adb-4760-8cdc-ef3b74b626f7avec l'actionpermit.ibmcloud tg pfc 9f559c43-63f4-4da5-b312-b525a8dce185 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7 --prefix 10.0.250.0/24 --action permitibmcloud tg prefix-filter-deleteSupprimer 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-6f53d86bc82bde la passerelle9f559c43-63f4-4da5-b312-b525a8dce185et de la connexion6c1bdc19-4adb-4760-8cdc-ef3b74b626f7ibmcloud tg pfd 9f559c43-63f4-4da5-b312-b525a8dce185 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7 b4dbe0a6-c52d-4128-cc32-6f53d86bc82bRapports de route
Cette section fournit des informations sur les commandes CLI relatives aux fonctions de rapport de routage.
ibmcloud tg route-reportsCette 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 $gatewayD'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-reportExtraire 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 $reportibmcloud tg route-report-createCré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 $gatewayibmcloud tg route-report-deleteSupprimer 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