Gerenciar Cloud Routers

Este documento descreve como listar, atualizar, conferir o status e excluir o Cloud Router.

Antes de começar

gcloud

Para usar os exemplos de linha de comando deste guia:

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

API

Para usar os exemplos da API deste guia, configure o acesso a ela.

Listar Cloud Routers

Para listar todos os Cloud Routers em um projeto, siga estas etapas.

Console

  1. No console Google Cloud , acesse a página Cloud Routers.

    Acesse o Cloud Routers

  2. Na página Cloud Routers, visualize 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:

  • PROJECT_ID: o ID do projeto em que você quer listar os Cloud Routers.
  • REGION: a região que você quer listar os roteadores. Por exemplo, asia-east1

A resposta será semelhante a:

  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 em que você quer listar os Cloud Routers.

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

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

Substitua:

  • PROJECT_ID: o ID do projeto em que você quer listar os Cloud Routers.
  • REGION: a região que você quer listar os Cloud Routers.

Atualizar Cloud Routers

Se um Cloud Router estiver associado a um gateway NCC, considere o seguinte:

  • Não é possível atualizar o campo ncc_gateway.

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

gcloud

Use o comando gcloud compute routers update:

gcloud compute routers update ROUTER_NAME
    --region=REGION

Substitua:

  • ROUTER_NAME: o nome do Cloud Router que você quer atualizar.
  • REGION: a região onde o Cloud Router está localizado

API

Use o método routers.update.

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

Substitua:

  • PROJECT_ID: o ID do projeto em que você quer listar os Cloud Routers.
  • REGION: a região onde o Cloud Router está localizado
  • ROUTER_NAME: o nome do Cloud Router que você quer atualizar.

Consultar o status 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:

  • ROUTER_NAME: o nome do Cloud Router de que você quer conferir o status.
  • PROJECT_ID: o ID do projeto ao qual o Cloud Router pertence
  • REGION: a região onde o Cloud Router está localizado

API

Use o método routers.getRouterStatus com um corpo de solicitação vazio:

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

Substitua:

  • PROJECT_ID: o ID do projeto ao qual o Cloud Router pertence
  • REGION: a região onde o Cloud Router está localizado
  • ROUTER_NAME: o nome do Cloud Router de que você quer conferir o status.

Excluir Cloud Routers

Antes de excluir um Cloud Router, verifique se ele não está sendo usado por outro recurso, como um túnel do Cloud VPN ou um anexo da VLAN. Você precisa excluir o recurso associado antes de excluir o Cloud Routers. No entanto, não é necessário remover as sessões do BGP antes de excluir o Cloud Router.

Para excluir o Cloud Router, siga estas etapas.

Console

  1. No console Google Cloud , acesse a página Cloud Routers.

    Acesse o Cloud Routers

  2. Marque a caixa de seleção ao lado do Cloud Router que você quer excluir.

  3. Clique em Excluir.

gcloud

Execute o comando delete. Especifique o nome e o local do Cloud Router que você quer excluir.

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

Substitua:

  • ROUTER_NAME: o nome do Cloud Router que você quer excluir

  • PROJECT_ID: o ID do projeto que contém o Cloud Router que você quer excluir.

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

O resultado será assim:

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:

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

A seguir