Administra Cloud Routers

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

Antes de comenzar

gcloud

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

  1. Instala Google Cloud CLI o actualízala a la última versión.
  2. Configura una región y una zona predeterminadas.

API

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

Enumera Cloud Routers

Para visualizar todos los Cloud Routers de un proyecto, sigue estos pasos.

Console

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

    Ir a Cloud Routers

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

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)]

Reemplaza lo siguiente:

  • PROJECT_ID: es el ID del proyecto en el que deseas enumerar los Cloud Routers
  • REGION es la región para la que deseas enumerar routers, por ejemplo, asia-east1.

El resultado es 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

Reemplaza PROJECT_ID por el ID del proyecto en el que deseas enumerar los routers.

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

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

Reemplaza lo siguiente:

  • PROJECT_ID: es el ID del proyecto en el que deseas enumerar los Cloud Routers
  • REGION es la región para la que deseas enumerar routers.

Actualiza Cloud Routers

Si un Cloud Router está asociado con una puerta de enlace 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

Reemplaza lo siguiente:

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

API

Usa el método routers.update:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que deseas enumerar los Cloud Routers.
  • REGION: Es la región en la que reside el Cloud Router.
  • ROUTER_NAME: Es el nombre del Cloud Router que deseas actualizar.

Obtén 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

Reemplaza lo siguiente:

  • ROUTER_NAME: Es el nombre del Cloud Router del que quieres obtener el estado.
  • PROJECT_ID: Es el ID del proyecto al que pertenece el Cloud Router.
  • REGION: Es la región en la que reside el 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

Reemplaza lo siguiente:

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

Borra los Cloud Routers

Antes de borrar Cloud Router, verifica que no lo use otro recurso, como un túnel de Cloud VPN o un adjunto de VLAN. Para poder borrar el router, primero debes borrar el recurso asociado. Sin embargo, no es necesario que quites las sesiones de BGP antes de borrar Cloud Router.

Para borrar el Cloud Router, sigue estos pasos.

Console

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

    Ir a Cloud Routers

  2. Selecciona la casilla de verificación que aparece junto al Cloud Router que deseas borrar.

  3. Haz clic en Borrar.

gcloud

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

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

Reemplaza lo siguiente:

  • ROUTER_NAME: Es el nombre del Cloud Router que deseas borrar.

  • PROJECT_ID: Es el ID del proyecto que contiene el Cloud Router que deseas borrar.

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

El resultado es similar a este:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto que contiene el Cloud Router que deseas borrar.
  • REGION es la región en la que se encuentra el Cloud Router.
  • ROUTER_NAME es el nombre del Cloud Router

¿Qué sigue?