Gestionar routers de Cloud Router

En este documento se describe cómo enumerar, actualizar, obtener el estado y eliminar Cloud Router.

Antes de empezar

gcloud

Si quieres usar los ejemplos de línea de comandos de esta guía, haz lo siguiente:

  1. Instala o actualiza a la versión más reciente de Google Cloud CLI.
  2. Define una región y una zona predeterminadas.

API

Si quieres usar los ejemplos de API de esta guía, configura el acceso a la API.

Listar routers de Cloud Router

Para enumerar todos los routers de Cloud de un proyecto, sigue estos pasos.

Consola

  1. En la Google Cloud consola, ve a la página Cloud Routers.

    Ir a Cloud Routers

  2. En la página Routers de Cloud Router, consulta la lista de tus routers de Cloud Router.

gcloud

Ejecuta el comando list. Para restringir la lista a una sola región, especifica --filter="region:(<var>REGION</var>).

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto del que quieres obtener la lista de Cloud Routers
  • REGION: la región de la que quieres obtener una lista de routers. Por ejemplo, asia-east1.

El resultado debería ser similar al siguiente:

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

API

Usa el método routers.aggregatedList:

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

Sustituye PROJECT_ID por el ID del proyecto del que quieras obtener una lista de Cloud Routers.

Para enumerar solo los routers de Cloud Router de una región específica, usa el método routers.list:

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto del que quieres obtener la lista de Cloud Routers
  • REGION: la región de la que quieres obtener una lista de Cloud Routers

Actualizar routers de Cloud Router

Si un Cloud Router está asociado a una pasarela de NCC, ten en cuenta lo siguiente:

  • No puedes actualizar el campo ncc_gateway.

  • Los métodos patch o update no aceptan el campo network como parte del cuerpo de la solicitud.

gcloud

Usa el comando gcloud compute routers update:

gcloud compute routers update ROUTER_NAME
    --region=REGION

Haz los cambios siguientes:

  • ROUTER_NAME: el nombre del Cloud Router que quieras actualizar
  • REGION: la región en la que reside Cloud Router

API

Usa el método routers.update:

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto del que quieres obtener la lista de Cloud Routers
  • REGION: la región en la que reside Cloud Router
  • ROUTER_NAME: el nombre del Cloud Router que quieras actualizar

Consultar el estado de Cloud Router

gcloud

Usa el comando gcloud compute routers get-status.

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

Haz los cambios siguientes:

  • ROUTER_NAME: el nombre del Cloud Router del que quieres obtener el estado.
  • PROJECT_ID: el ID del proyecto al que pertenece el Cloud Router.
  • REGION: la región en la que reside Cloud Router

API

Usa el método routers.getRouterStatus con un cuerpo de solicitud vacío:

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto al que pertenece el Cloud Router.
  • REGION: la región en la que reside Cloud Router
  • ROUTER_NAME: el nombre del Cloud Router del que quieres obtener el estado.

Eliminar routers de Cloud Router

Antes de eliminar un Cloud Router, comprueba que no lo esté usando otro recurso, como un túnel de Cloud VPN o una vinculación de VLAN. Debes eliminar el recurso asociado para poder eliminar el Cloud Router. Sin embargo, no es necesario que elimine las sesiones de BGP antes de eliminar el Cloud Router.

Para eliminar el Cloud Router, sigue estos pasos.

Consola

  1. En la Google Cloud consola, ve a la página Cloud Routers.

    Ir a Cloud Routers

  2. Seleccione la casilla situada junto al Cloud Router que quiera eliminar.

  3. Haz clic en Eliminar.

gcloud

Ejecuta el comando delete. Especifica el nombre y la ubicación del Cloud Router que quieras eliminar.

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

Haz los cambios siguientes:

  • ROUTER_NAME: el nombre del Cloud Router que quieres eliminar

  • PROJECT_ID: el ID del proyecto que contiene el Cloud Router que quieres eliminar

  • REGION: la región en la que se encuentra Cloud Router

El resultado debería ser similar al siguiente:

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

API

Usa el método routers.delete:

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto que contiene el Cloud Router que quieres eliminar
  • REGION: región en la que se encuentra Cloud Router
  • ROUTER_NAME: el nombre de Cloud Router

Siguientes pasos