Faça a gestão dos Cloud Routers

Este documento descreve como listar, atualizar, obter o estado e eliminar o Cloud Router.

Antes de começar

gcloud

Se quiser usar os exemplos de linhas de comandos neste guia, faça o seguinte:

  1. Instale ou atualize para a versão mais recente da CLI do Google Cloud.
  2. Defina uma região e uma zona predefinidas.

API

Se quiser usar os exemplos de API neste guia, configure o acesso à API.

Liste os Cloud Routers

Para listar todos os Cloud Routers num projeto, siga estes passos.

Consola

  1. Na Google Cloud consola, aceda à página Routers na nuvem.

    Aceder aos Cloud Routers

  2. Na página Cloud Routers, veja uma lista dos seus Cloud Routers.

gcloud

Execute o comando list. Para restringir a lista a apenas uma região, especifique --filter="region:(<var>REGION</var>).

  gcloud compute routers list \
      --project=PROJECT_ID \
      [--filter="region:(REGION)]

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto para o qual quer listar Cloud Routers
  • REGION: a região para a qual quer listar os routers, por exemplo, asia-east1

O resultado é semelhante ao seguinte:

  NAME        REGION       NETWORK
  my-router   asia-east1   my-network

API

Use o método routers.aggregatedList:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/routers

Substitua PROJECT_ID pelo ID do projeto para o qual quer listar os routers na nuvem.

Para listar apenas os Cloud Routers numa região específica, use o método routers.list:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto para o qual quer listar Cloud Routers
  • REGION: a região para a qual quer listar os Cloud Routers

Atualize os Cloud Routers

Se um Cloud Router estiver associado a um gateway do NCC, tenha em atenção o seguinte:

  • Não pode atualizar o campo ncc_gateway.

  • Os métodos patch ou update não aceitam o campo network como parte do corpo do pedido.

gcloud

Use o comando gcloud compute routers update:

gcloud compute routers update ROUTER_NAME
    --region=REGION

Substitua o seguinte:

  • ROUTER_NAME: o nome do Cloud Router que quer atualizar
  • REGION: a região onde o Cloud Router reside

API

Use o método routers.update:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto para o qual quer listar os Cloud Routers
  • REGION: a região onde o Cloud Router reside
  • ROUTER_NAME: o nome do Cloud Router que quer atualizar

Obtenha o estado do Cloud Router

gcloud

Use o comando gcloud compute routers get-status.

gcloud compute routers get-status ROUTER_NAME \
    --project=PROJECT_ID \
    --region=REGION

Substitua o seguinte:

  • ROUTER_NAME: o nome do Cloud Router cujo estado quer obter
  • PROJECT_ID: o ID do projeto ao qual o Cloud Router pertence
  • REGION: a região onde o Cloud Router reside

API

Use o método routers.getRouterStatus com um corpo do pedido vazio:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/getRouterStatus

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto ao qual o Cloud Router pertence
  • REGION: a região onde o Cloud Router reside
  • ROUTER_NAME: o nome do Cloud Router cujo estado quer obter

Elimine Cloud Routers

Antes de eliminar um Cloud Router, verifique se não está a ser usado por outro recurso, como um túnel de VPN do Google Cloud ou uma associação de VLAN. Tem de eliminar o recurso associado antes de poder eliminar o Cloud Router. No entanto, não tem de remover as sessões BGP antes de eliminar o Cloud Router.

Para eliminar o router na nuvem, siga estes passos.

Consola

  1. Na Google Cloud consola, aceda à página Routers na nuvem.

    Aceder aos Cloud Routers

  2. Selecione a caixa de verificação junto ao Cloud Router que quer eliminar.

  3. Clique em Eliminar.

gcloud

Execute o comando delete. Especifique o nome e a localização do Cloud Router que quer eliminar.

gcloud compute routers delete ROUTER_NAME \
    --project=PROJECT_ID \
    --region=REGION

Substitua o seguinte:

  • ROUTER_NAME: o nome do Cloud Router que quer eliminar

  • PROJECT_ID: o ID do projeto que contém o Cloud Router que quer eliminar

  • REGION: a região em que o Cloud Router está localizado

O resultado é semelhante ao seguinte:

Deleted [https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/asia-east1/routers/ROUTER_NAME].

API

Use o método routers.delete:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto que contém o Cloud Router que quer eliminar
  • REGION: a região onde o Cloud Router está localizado
  • ROUTER_NAME: o nome do Cloud Router

O que se segue?

  • Para ver a configuração de um Cloud Router, as respetivas sessões BGP e as rotas que o Cloud Router está a anunciar, consulte Ver detalhes do router.
  • Para resolver problemas ao usar o Cloud Router, consulte o artigo Resolução de problemas.