CLI do Transit Gateway

A linha de comando IBM Cloud® Transit Gateway fornece uma interface para o serviço Transit Gateway. É possível usar a CLI para criar e gerenciar gateways e conexões e listar locais disponíveis para gateways.

Antes de Iniciar

Siga estas instruções para usar a interface da linha de comandos do Transit Gateway, que é implementada como um plug-in da CLI do IBM Cloud.

Instale a CLI do IBM Cloud.
Instale o plug-in da CLI tg-cli/tg na CLI do IBM Cloud.

Para instalar:
```
ibmcloud plugin install tg
```

Se a CLI for utilizada com um Virtual Private Endpoint (VPE), você deve configurar a seguinte variável:

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

`ibmcloud plugin show tg`

Mostrar informações do plug-in da CLI do Transit Gateway.

ibmcloud plugin show tg

Gateways de trânsito

Esta seção fornece informações sobre os comandos da CLI para as funções do gateway.

`ibmcloud tg gateway`

Recuperar detalhes sobre um gateway específico.

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

Opções de comando

GATEWAY_ID: ID do gateway sobre o qual você deseja obter detalhes.
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Solicitar detalhes do gateway.

ibmcloud tg gw $gateway

`ibmcloud tg gateways`

Listar gateways de trânsito.

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

Opções de comando

--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Outros comandos exigem uma ID de gateway. Salve o ID como uma variável de ambiente para poder usá-lo mais tarde, por exemplo:

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

`ibmcloud tg gateway-create`

Criar um gateway de trânsito.

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]

Opções de comando

--name: Nome do novo gateway.
--location: Localização do gateway (consulte os valores possíveis em ibmcloud tg locations)
--routing: Roteamento de gateway de recursos (global | local). Selecione global para conectar recursos entre regiões. O valor padrão é local.
--resource-group-id: Opcional: ID do grupo de recursos do gateway. Usa o grupo de recursos padrão, se não especificado.
--gre-enhanced-route-propagation: Opcional: Especifique se você deseja ativar a propagação de rota em todos os GREs conectados ao mesmo gateway de trânsito. Os valores válidos são true e false (padrão).
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Crie um gateway chamado myGateway em us-south com roteamento local e que use o grupo de recursos padrão.

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

`ibmcloud tg gateway-delete`

Excluir um gateway existente.

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

Opções de comando

GATEWAY_ID: ID do gateway que você deseja excluir.
--force | -f: Opcional: Forçar a exclusão sem confirmação.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Excluir o gateway sem confirmação.

ibmcloud tg gwd $gateway -f

`ibmcloud tg gateway-update`

Atualizar propriedades em um gateway existente.

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

Opções de comando

GATEWAY_ID

ID do gateway que você deseja atualizar.

--name

Opcional: Novo nome do gateway.

--routing

Opcional: Roteamento de gateway de recursos (global | local). Selecione global para conectar recursos entre regiões. A alteração do roteamento de global para local exige que todas as conexões existentes sejam direcionadas para local.

--gre-enhanced-route-propagation

Opcional: Especifique se você deseja ativar a propagação de rota em todos os GREs conectados ao mesmo gateway de trânsito. Os valores válidos são true e false (padrão).

Após alterar esse valor, aguarde alguns minutos para que a alteração tenha efeito.

--output json

Opcional: Especifique se deseja que a saída seja exibida no formato JSON.

--help | -h

Opcional: Obtenha ajuda sobre este comando.

Exemplo

Atualize o gateway com um valor de roteamento de global.

ibmcloud tg gwu $gateway --routing global

Conexões

Esta seção fornece informações sobre os comandos da CLI para funções de conexão.

`ibmcloud tg acc-connections`

Liste todas as conexões de conta no gateway de trânsito.

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

Opções de comando

--network-id

Opcional. Para classic, não defina um valor. Use o CRN para todos os outros tipos de rede. Por exemplo, para descobrir o CRN de uma VPC:

ibmcloud is vpc VPC_ID --json

--network-type: Opcional. Tipo de rede da conexão. Os valores são classic, directlink, power_virtual_server, vpn_gateway, e vpc.
--all-pages: Opcional: Lista todas as conexões, independentemente de ter sido especificado um tamanho de --limit.
--limit NUMERIC_VALUE: Opcional: O número máximo de recursos a serem retornados por página. O limite padrão é 50. Valores possíveis: 1 ≤ valor ≤ 500
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplos

Liste todas as conexões de conta:

ibmcloud tg acc-connections|ac

Lista de conexões de conta filtradas por tipo de rede:

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

`ibmcloud tg connection`

Recuperar detalhes sobre uma conexão específica.

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

Opções de comando

GATEWAY_ID: ID do gateway no qual a conexão está ativa.
CONNECTION_ID: ID da conexão sobre a qual você deseja obter detalhes.
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Solicitar detalhes de um ID de conexão específico.

ibmcloud tg c $gateway $connection

`ibmcloud tg connections`

Listar as conexões no gateway de trânsito.

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

Opções de comando

GATEWAY_ID: ID do gateway para o qual você deseja estabelecer conexões.
--all-pages (Selecione a disponibilidade no momento): Lista todas as conexões, independentemente de ter sido especificado um tamanho de --limit.
--limit (Selecione a disponibilidade no momento): O número máximo de recursos a serem retornados por página. O limite padrão é 100. Valores possíveis: 1 ≤ valor ≤ 500
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Listar as conexões no gateway.

ibmcloud tg cs $gateway

Outros comandos exigem uma ID de conexão. Salve o ID como uma variável de ambiente para poder usá-lo mais tarde, por exemplo:

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

`ibmcloud tg connection-create`

Crie uma conexão no gateway de trânsito.

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]

Opções de comando

GATEWAY_ID: ID do gateway no qual a nova conexão está ativa.
--name: Nome da nova conexão.
--network-id: ID da conexão de rede. Para classic, não defina um valor. Use o CRN para todos os outros tipos de rede. Por exemplo, para descobrir o CRN de uma VPC:

ibmcloud is vpc VPC_ID --json

--network-type: Tipo de rede da conexão. Os valores são classic, directlink, power_virtual_server, vpn_gateway, e vpc.
--network-account-id: ID da conta do IBM Cloud a ser usada para criar uma conexão clássica. Utilizado apenas com o tipo “ classic ”, quando a conta da conexão é diferente da conta do gateway.
--zone: Opcional: Zona de disponibilidade na qual será implantado um túnel GRE ou uma conexão VPN. Aplicável somente ao tipo de rede vpn_gateway.
--default-prefix-filter: Opcional: Filtro de prefixo padrão da conexão (permit | deny).
--cidr: Opcional: bloco CIDR a ser usado para a conexão. Aplicável somente ao tipo de rede vpn_gateway.
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Crie uma conexão VPC com o nome vpc-connection e use 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

Crie uma conexão clássica chamada classic-conn.

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

`ibmcloud tg connection-delete`

Excluir uma conexão existente.

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

Opções de comando

GATEWAY_ID: ID do gateway da conexão que está sendo excluída.
CONNECTION_ID: ID da conexão que está sendo excluída.
--force | -f: Opcional: Forçar a exclusão sem confirmação.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Excluir a conexão sem confirmação.

ibmcloud tg cd $gateway $connection -f

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

Esse comando foi descontinuado. Use o comando tg-connection-gre-create.

Crie uma conexão de túnel GRE (Generic Routing Encapsulation) no gateway de trânsito.

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]

Opções de comando

GATEWAY_ID ID do gateway ao qual a nova conexão está vinculada.

--name: Nome da nova conexão GRE.
--zone: Zona de disponibilidade para o túnel GRE. Exemplo:us-south-1
--local-gateway-ip: Endereço IP do gateway local para a conexão do túnel GRE.
--local-tunnel-ip: Endereço IP local do túnel para a conexão do túnel GRE.
--remote-gateway-ip: Endereço IP do gateway remoto para a conexão do túnel GRE.
--remote-tunnel-ip: Endereço IP do túnel remoto para a conexão do túnel GRE.
--base-connection-id: Opcional: ID da conexão de rede clássica que serve de base para o túnel GRE. Essa opção deve ser usada somente com o tipo de rede gre_tunnel.
--base-network-type: Tipo de rede da conexão principal (classic).
--network-type: Opcional: Tipo de rede da conexão GRE. O valor padrão é gre_tunnel.
--network-account-id: Opcional: ID da conta a ser conectada a uma conexão clássica. Utilize apenas com o tipo “ classic ” quando a conta da conexão for diferente da conta do gateway.
--remote-bgp-asn: Opcional: Se o ASN BGP remoto não for especificado, será gerado um.
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplos

Crie uma conexão de túnel GRE chamada “ gre-connection ” e que utilize a conexão clássica “ 9037f710-8dfb-4948-a2bd-847c8dde96d3 ” como conexão 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`

Aprove uma conexão de outra conta como o proprietário da rede.

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

Opções de comando

GATEWAY_ID: ID do gateway no qual a conexão está ativa.
CONNECTION_ID: ID da conexão que você está aprovando.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Aprove a solicitação de conexão.

ibmcloud tg ca $gateway $connection

`ibmcloud tg connection-gre-create`

Crie um túnel GRE (Generic Routing Encapsulation) ou uma conexão GRE desvinculada no gateway de trânsito.

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]

Opções de comando

GATEWAY_ID: ID do gateway ao qual a nova conexão está vinculada.
--name: Nome da nova conexão GRE.
--zone: Zona de disponibilidade para o túnel GRE. Exemplo:us-south-1
--local-gateway-ip: Endereço IP do gateway local para a conexão do túnel GRE.
--local-tunnel-ip: Endereço IP local do túnel para a conexão do túnel GRE.
--remote-gateway-ip: Endereço IP do gateway remoto para a conexão do túnel GRE.
--remote-tunnel-ip: Endereço IP do túnel remoto para a conexão do túnel GRE.
--base-connection-id: Opcional: ID da conexão de rede clássica que serve de base para o túnel GRE. Essa opção deve ser usada somente com o tipo de rede gre_tunnel.
--base-network-type: Opcional: Tipo de rede da conexão principal (classic).
--network-type: Opcional: Tipo de rede da conexão GRE. Os valores são gre_tunnel ou unbound_gre_tunnel. O valor padrão é gre_tunnel.
--network-account-id: Opcional: ID da conta a ser conectada a uma conexão clássica. Utilize apenas com o tipo “ classic ” quando a conta da conexão for diferente da conta do gateway.
--remote-bgp-asn: Opcional: Se o ASN BGP remoto não for especificado, será gerado um.
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplos

Crie uma conexão de túnel GRE chamada “ gre-connection ” e que utilize a conexão clássica “ 9037f710-8dfb-4948-a2bd-847c8dde96d3 ” como conexão 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`

Rejeite uma conexão de outra conta como o proprietário da rede.

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

Opções de comando

GATEWAY_ID: ID do gateway no qual a conexão está ativa.
CONNECTION_ID: ID da conexão que você está rejeitando.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Rejeite a solicitação de conexão.

ibmcloud tg cr $gateway $connection

`ibmcloud tg connection-rgre-create`

Crie uma conexão GRE redundante no gateway de trânsito.

Você deve usar um arquivo JSON como entrada.

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

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

Opções de comando

gateway_id: ID do gateway em que está a nova conexão GRE redundante.
name: Nome da nova conexão GRE redundante.
network_type: Tipo de rede da conexão. O valor é redundant_gre.

base_network_type O tipo de rede a ser utilizada. As opções são classic e vpc.

network_account_id: ID da conta IBM Cloud a ser usada para uma rede clássica entre contas. Utilizado apenas com o tipo “ classic ”, quando a conta da conexão é diferente da conta do gateway. Essa opção não é válida para o tipo de rede básica vpc.
network_id: O CRN da rede VPC a ser usada. Essa opção não é válida para o tipo de rede básica classic. Por exemplo, para descobrir o CRN de uma VPC:

ibmcloud is vpc VPC_ID --json

tunnels

Informações sobre os túneis GRE.

local_gateway_ip

Endereço IP do gateway local para a conexão do túnel GRE. Esse campo é obrigatório para conexões do tipo de rede redundant_gre.

Ao usar um tipo de rede de base vpc, esse endereço IP deve estar em conformidade com a RFC 1918 e não ser um endereço IP dentro do intervalo multicast de 224.0.0.0 a 239.255.255.255 e não pode estar em conflito com nenhuma rede existente que esteja conectada ao gateway de trânsito. Além disso, esse endereço IP não pode ser usado como local-gateway-ip para outro GRE usando a mesma rede subjacente.

local_tunnel_ip

Endereço IP local do túnel atribuído ao lado Transit Gateway do túnel. Os endereços local_tunnel_ip e remote_tunnel_ip devem estar na mesma rede /30. E nenhum deles pode ser o endereço de rede ou o endereço de transmissão. Esse campo é obrigatório para conexões do tipo de rede redundant_gre.

name

Nome do túnel GRE.

remote_bgp_asn

Opcional: Se o ASN BGP remoto não for especificado, será gerado um.

remote_gateway_ip

Endereço IP do gateway remoto para a conexão do túnel GRE.

remote_tunnel_ip

Endereço IP do túnel remoto para a conexão do túnel GRE.

zone

Zona de disponibilidade para o túnel GRE. Exemplo:us-south-1

`ibmcloud tg connection-update`

Atualizar propriedades em uma conexão existente.

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

Opções de comando

GATEWAY_ID: O ID do gateway no qual a conexão está sendo atualizada está ativado.
CONNECTION_ID: ID da conexão a ser atualizada.
--name: Novo nome da conexão.
--default-prefix-filter: Opcional: Filtro de prefixo padrão da conexão (permit | deny).
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Atualizar o nome da conexão para MyConn2.

ibmcloud tg cu $gateway $connection --name MyConn2

`ibmcloud tg redundant-gre-tunnel-add`

Adicionar um túnel a um GRE redundante.

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]

Opções de comando

GATEWAY_ID: ID do gateway ao qual a nova conexão está vinculada.
REDUNDANT_GRE_ID: ID da conexão GRE redundante.
--name: Nome do novo túnel GRE.
--zone: Zona de disponibilidade para o túnel GRE. Exemplo:us-south-1
--local-gateway-ip: Endereço IP do gateway local para a conexão do túnel GRE.
--local-tunnel-ip: Endereço IP local do túnel para a conexão do túnel GRE.
--remote-gateway-ip: Endereço IP do gateway remoto para a conexão do túnel GRE.
--remote-tunnel-ip: Endereço IP do túnel remoto para a conexão do túnel GRE.
--remote-bgp-asn: Opcional: Se o ASN BGP remoto não for especificado, será gerado um.
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

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`

Remover um túnel de um GRE redundante.

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

Opções de comando

GATEWAY_ID: ID do gateway ao qual a nova conexão está vinculada.
REDUNDANT_GRE_ID: ID da conexão GRE redundante.
TUNNEL_ID: ID do túnel a ser excluído.
--force | -f: Opcional: Forçar a exclusão sem confirmação.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

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

`ibmcloud tg tunnels`

Liste todos os túneis em um determinado GRE redundante.

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

Opções de comando

GATEWAY_ID: ID do gateway ao qual a nova conexão está vinculada.
REDUNDANT_GRE_ID: ID da conexão GRE redundante.
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--force | -f: Opcional: Forçar a exclusão sem confirmação.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

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

Localizações

Esta seção fornece informações sobre os comandos da CLI para funções de localização.

`ibmcloud tg locations`

Use esse comando para listar possíveis locais para criar um gateway.

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

Opções de comando

--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

`ibmcloud tg location`

Recupera informações específicas para esse local.

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

Opções de comando

NAME: Nome do local sobre o qual você deseja obter detalhes.
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Solicitar detalhes para o local us-south.

ibmcloud tg location us-south

Filtros de prefixo de conexão

Esta seção fornece informações sobre os comandos da CLI para as funções de filtragem de prefixos de conexão.

`ibmcloud tg prefix-filter-create`

Adicionar filtro de prefixo à conexão.

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

Opções de comando

GATEWAY_ID: ID do gateway ao qual o filtro de prefixo está sendo aplicado.
CONNECTION_ID: ID da conexão à qual o filtro de prefixo está sendo aplicado.
--prefix: Prefixo de rede ao qual o filtro é aplicado.
--action: Ação a ser realizada com o prefixo especificado (permit | deny).
--le: Opcional: Filtro de prefixo aplicado a uma máscara de sub-rede menor ou igual a este valor.
--ge: Opcional: Filtro de prefixo aplicado a uma máscara de sub-rede maior ou igual a este valor.
--before: Opcional: Identificador do filtro de prefixo ao qual este filtro deve ser aplicado antes. Se vazio, este filtro será aplicado por último.
--output: Opcional: Especifique o formato de saída; apenas o formato “ json ” é compatível. Todos os detalhes são exibidos.

Exemplos

Adicionar filtro de prefixo para 10.0.250.0/24 ao gateway 9f559c43-63f4-4da5-b312-b525a8dce185, conexão 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7 com a ação 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`

Excluir filtro de prefixo da conexão.

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

Opções de comando

GATEWAY_ID: ID do gateway do qual o filtro de prefixo foi excluído.
CONNECTION_ID: ID da conexão da qual o filtro de prefixo foi excluído.
FILTER_ID: ID do filtro de prefixo que está sendo excluído.
--force, -f: Forçar a operação de exclusão sem confirmação.

Exemplos

Excluir ID do filtro de prefixo b4dbe0a6-c52d-4128-cc32-6f53d86bc82b do gateway 9f559c43-63f4-4da5-b312-b525a8dce185 e conexão 6c1bdc19-4adb-4760-8cdc-ef3b74b626f7

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

Relatórios de rotas

Esta seção fornece informações sobre os comandos da CLI para as funções de relatório de rota.

`ibmcloud tg route-reports`

Use este comando para listar relatórios de rotas disponíveis em um gateway.

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

Opções de comando

GATEWAY_ID: ID do gateway para o qual se deseja listar os relatórios de rota.
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Listar os relatórios de rotas no gateway.

ibmcloud tg rrs $gateway

Outros comandos exigem uma ID de relatório de rota. Salve o ID como uma variável de ambiente para poder usá-lo mais tarde, por exemplo:

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

`ibmcloud tg route-report`

Recuperar detalhes sobre um relatório de rotas específico.

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

Opções de comando

GATEWAY_ID: ID do gateway de origem do relatório de rota.
REPORT_ID: ID do relatório de rota sobre o qual você deseja obter detalhes.
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Solicitar detalhes para um relatório de rotas.

ibmcloud tg rr $gateway $report

`ibmcloud tg route-report-create`

Criar um relatório de rotas.

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

Opções de comando

GATEWAY_ID: ID do gateway para o qual o relatório de rota foi criado.
--output json: Opcional: Especifique se deseja que a saída seja exibida no formato JSON.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Criar um relatório de rotas para um gateway.

ibmcloud tg rrc $gateway

`ibmcloud tg route-report-delete`

Excluir um relatório de rotas existente.

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

Opções de comando

GATEWAY_ID: ID do gateway ao qual o relatório se refere.
REPORT_ID: ID do relatório que você deseja excluir.
--force | -f: Opcional: Forçar a exclusão sem confirmação.
--help | -h: Opcional: Obtenha ajuda sobre este comando.

Exemplo

Excluir relatório de rotas sem confirmação.

ibmcloud tg rrd $gateway $report -f

CLI do Transit Gateway

CLI do Transit Gateway

Antes de Iniciar

ibmcloud plugin show tg

Gateways de trânsito

ibmcloud tg gateway

Opções de comando

Exemplo

ibmcloud tg gateways

Opções de comando

ibmcloud tg gateway-create

Opções de comando

Exemplo

ibmcloud tg gateway-delete

Opções de comando

Exemplo

ibmcloud tg gateway-update

Opções de comando

Exemplo

Conexões

ibmcloud tg acc-connections

Opções de comando

Exemplos

ibmcloud tg connection

Opções de comando

Exemplo

ibmcloud tg connections

Opções de comando

Exemplo

ibmcloud tg connection-create

Opções de comando

Exemplo

ibmcloud tg connection-delete

Opções de comando

Exemplo

ibmcloud tg connection-create-gre (Descontinuado)

Opções de comando

Exemplos

ibmcloud tg connection-approve

Opções de comando

Exemplo

ibmcloud tg connection-gre-create

Opções de comando

Exemplos

ibmcloud tg connection-reject

Opções de comando

Exemplo

ibmcloud tg connection-rgre-create

Arquivo JSON

Opções de comando

ibmcloud tg connection-update

Opções de comando

Exemplo

ibmcloud tg redundant-gre-tunnel-add

Opções de comando

Exemplo

ibmcloud tg redundant-gre-tunnel-remove

Opções de comando

Exemplo

ibmcloud tg tunnels

Opções de comando

Exemplo

Localizações

ibmcloud tg locations

Opções de comando

ibmcloud tg location

Opções de comando

Exemplo

Filtros de prefixo de conexão

ibmcloud tg prefix-filter-create

Opções de comando

Exemplos

ibmcloud tg prefix-filter-delete

Opções de comando

Exemplos

Relatórios de rotas

ibmcloud tg route-reports

Opções de comando

Exemplo

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

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