Gestione dei router Cloud

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

Prima di iniziare

gcloud

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

  1. Installa o esegui l'aggiornamento all'ultima versione 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 alle API.

Elenca i router Cloud

Per elencare tutti i router Cloud in un progetto:

Console

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

    Vai a Router Cloud

  2. Nella pagina Router Cloud, 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 il quale vuoi elencare i router Cloud
  • REGION: la regione per la quale 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 routers.aggregatedList metodo:

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

Sostituisci PROJECT_ID con l'ID del progetto per il quale vuoi elencare i router Cloud.

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

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto per il quale vuoi elencare i router Cloud
  • REGION: la regione per la quale 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 si trova 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 il quale vuoi elencare i router Cloud
  • REGION: la regione in cui si trova il router Cloud
  • ROUTER_NAME: il nome del router Cloud che vuoi aggiornare

Ottieni 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 ottenere lo stato
  • PROJECT_ID: l'ID progetto a cui appartiene il router Cloud
  • REGION: la regione in cui si trova il router Cloud

API

Utilizza il routers.getRouterStatus metodo 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 si trova il router Cloud
  • ROUTER_NAME: il nome del router Cloud di cui vuoi ottenere lo stato

Elimina 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. Prima di eliminare il router Cloud, devi eliminare la risorsa associata. Tuttavia, non è necessario rimuovere le sessioni BGP prima di eliminare il router Cloud.

Per eliminare il router Cloud:

Console

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

    Vai a Router Cloud

  2. Seleziona la casella di controllo accanto al router Cloud che vuoi eliminare.

  3. Fai clic su Elimina.

gcloud

Esegui il comando delete. Specifica il nome e la località 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 che vuoi 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 che vuoi eliminare
  • REGION: la regione in cui si trova il router Cloud
  • ROUTER_NAME: il nome del router Cloud

Passaggi successivi