Gestione dei router Cloud

Questo documento descrive come elencare, aggiornare, ottenere lo stato ed eliminare router Cloud.

Prima di iniziare

gcloud

Se vuoi utilizzare gli esempi di riga di comando in questa guida:

  1. Installa o esegui l'aggiornamento alla versione più recente di Google Cloud CLI.
  2. Imposta una regione e una zona predefinite.

API

Se vuoi utilizzare gli esempi di API in questa guida, configura l'accesso API.

Elenca i router Cloud

Per elencare tutti i router Cloud in un progetto:

Console

  1. Nella Google Cloud console, vai alla pagina Cloud Routers.

    Vai a Router Cloud

  2. Nella pagina Cloud Router, visualizza un elenco dei tuoi router Cloud.

gcloud

Esegui il comando list. Per limitare l'elenco a una sola regione, specifica --filter="region:(<var>REGION</var>).

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto per cui vuoi elencare i router Cloud
  • REGION: la regione per cui vuoi elencare i router, ad esempio asia-east1

L'output è simile al seguente:

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

API

Utilizza il metodo routers.aggregatedList:

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

Sostituisci PROJECT_ID con l'ID del progetto per cui vuoi elencare i router cloud.

Per elencare solo i router cloud in una regione specifica, utilizza il metodo routers.list:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto per cui vuoi elencare i router Cloud
  • REGION: la regione per cui vuoi elencare i router cloud

Aggiorna i router Cloud

Se un router Cloud è associato a un gateway NCC, tieni presente quanto segue:

  • Non puoi aggiornare il campo ncc_gateway.

  • I metodi patch o update non accettano il campo network come parte del corpo della richiesta.

gcloud

Utilizza il comando gcloud compute routers update:

gcloud compute routers update ROUTER_NAME
    --region=REGION

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del router Cloud che vuoi aggiornare
  • REGION: la regione in cui risiede il Router Cloud

API

Utilizza il metodo routers.update:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto per cui vuoi elencare i router cloud
  • REGION: la regione in cui risiede il Router Cloud
  • ROUTER_NAME: il nome del router Cloud che vuoi aggiornare

Ottenere lo stato del router Cloud

gcloud

Utilizza il comando gcloud compute routers get-status.

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

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del router Cloud di cui vuoi recuperare lo stato
  • PROJECT_ID: l'ID progetto a cui appartiene il router Cloud
  • REGION: la regione in cui risiede il Router Cloud

API

Utilizza il metodo routers.getRouterStatus con un corpo della richiesta vuoto:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto a cui appartiene il router Cloud
  • REGION: la regione in cui risiede il Router Cloud
  • ROUTER_NAME: il nome del router Cloud di cui vuoi recuperare lo stato

Eliminare i router Cloud

Prima di eliminare un router Cloud, verifica che non sia utilizzato da un'altra risorsa, ad esempio un tunnel Cloud VPN o un collegamento VLAN. Devi eliminare la risorsa associata prima di poter eliminare il router Cloud. Tuttavia, non è necessario rimuovere le sessioni BGP prima di eliminare il router Cloud.

Per eliminare il router cloud:

Console

  1. Nella Google Cloud console, vai alla pagina Cloud Routers.

    Vai a Router Cloud

  2. Seleziona la casella di controllo accanto al router cloud da eliminare.

  3. Fai clic su Elimina.

gcloud

Esegui il comando delete. Specifica il nome e la posizione del router cloud che vuoi eliminare.

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

Sostituisci quanto segue:

  • ROUTER_NAME: il nome del router Cloud che vuoi eliminare

  • PROJECT_ID: l'ID del progetto che contiene il router Cloud da eliminare

  • REGION: la regione in cui si trova il Router Cloud

L'output è simile al seguente:

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

API

Utilizza il metodo routers.delete:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto che contiene il router Cloud da eliminare
  • REGION: la regione in cui si trova il router Cloud
  • ROUTER_NAME: il nome del router Cloud

Passaggi successivi