Gestire le connessioni

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni delle fasi di lancio.

Questa pagina descrive i passaggi per visualizzare, aggiornare ed eliminare le connessioni Partner Cross-Cloud Interconnect per Amazon Web Services (AWS). Per visualizzare, aggiornare o eliminare una connessione, utilizza la risorsa transport.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni o dei seguenti ruoli IAM.

Autorizzazioni

• networkconnectivity.remoteTransportProfiles.get per ottenere i profili di trasporto
• networkconnectivity.remoteTransportProfiles.list per elencare i profili di trasporto
• networkconnectivity.transports.get per visualizzare i trasporti
• networkconnectivity.transports.list per visualizzare i trasporti
• networkconnectivity.transports.update per aggiornare un trasporto
• Networkconnectivity.transports.delete per eliminare un trasporto

Ruoli (uno dei seguenti)

• roles/networkconnectivity.transportAdmin per creare un trasporto
• roles/compute.networkAdmin per creare un trasporto
• roles/networkconnectivity.transportViewer per visualizzare un trasporto

Visualizza connessioni

Per visualizzare le connessioni, segui questi passaggi.

gcloud

Utilizza il comando gcloud network-connectivity transports list.

gcloud beta network-connectivity transports list \
    --region=LOCATION

L'output è simile al seguente:

gcloud network-connectivity transport list --region us-east4

| Name              | Profile              | Bandwidth | State  |
|===================|======================|===========|========|
| my-cci-aws        | aws-us-east-1        | 1 Gb/s    | Active |
| my-cci-aws-123456 | aws-us-east-1        | 1 Gb/s    | Active |

Sostituisci i seguenti valori:

• TRANSPORT_NAME: il nome del trasporto per cui vuoi visualizzare i dettagli
• LOCATION: la posizione in cui si trova la connessione

Per ottenere i dettagli di un singolo trasporto, utilizza il comando gcloud beta network-connectivity transports describe.

gcloud beta network-connectivity transports describe TRANSPORT_NAME \
    --region=LOCATION

Sostituisci i seguenti valori:

• TRANSPORT_NAME: il nome del trasporto per cui vuoi visualizzare i dettagli
• LOCATION: la posizione in cui si trova la connessione

API

Per elencare tutti i trasporti in un progetto e una località specifici, utilizza il metodo networkconnectivity.transports.list con un corpo della richiesta vuoto.

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://networkconnectivity.googleapis.com/v1beta/projects/PROJECT/locations/LOCATION/transports"

Sostituisci i seguenti valori:

• PROJECT: il nome del progetto
• LOCATION: la posizione in cui si trova la connessione

Per ottenere i dettagli di un singolo trasporto, utilizza il metodo networkconnectivity.transports.get.

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://networkconnectivity.googleapis.com/v1beta/projects/PROJECT/locations/LOCATION/transports/TRANSPORT_NAME"

Sostituisci i seguenti valori:

• PROJECT: il nome del progetto
• LOCATION: la posizione in cui si trova la connessione
• TRANSPORT_NAME: il nome del trasporto per cui vuoi visualizzare i dettagli

Aggiornare le connessioni

Puoi aggiornare i seguenti due parametri della risorsa di trasporto:

• description
• advertisedRoutes

La modifica delle route annunciate cambia le route raggiungibili da AWS. Devi fornire i campi aggiornati in una maschera nel parametro di query.

API

Utilizza il metodo networkconnectivity.transports.patch.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://networkconnectivity.googleapis.com/v1beta/projects/PROJECT/locations/LOCATION/transports/TRANSPORT_NAME" --data '{
"advertisedRoutes": ["IP_RANGE"]
}'

Sostituisci i seguenti valori:

• PROJECT: il nome del progetto
• LOCATION: la posizione in cui si trova la connessione
• TRANSPORT_NAME: il nome del trasporto che vuoi aggiornare
• IP_RANGE: l'intervallo IP delle route pubblicizzate, ad esempio 10.128.0.0/9

La risposta è simile alla seguente:

{
  {
      "advertisedRoutes": [
       "10.128.0.0/9"
      ],
      "description": NEW_DESCRIPTION,
      "updateTime": TIME
  }
}

Eliminazione delle connessioni

L'eliminazione di un trasporto non elimina la risorsa sul lato AWS, quindi assicurati di pulire entrambi i lati della connessione.

gcloud

Utilizza il comando gcloud beta network-connectivity transports delete.

gcloud beta network-connectivity transports delete TRANSPORT_NAME
    --region=LOCATION

Sostituisci i seguenti valori:

• TRANSPORT_NAME: il nome del trasporto che vuoi eliminare
• LOCATION: la posizione in cui si trova il trasporto

API

Per eliminare un singolo trasporto, utilizza il metodo networkconnectivity.transports.delete con un corpo della richiesta vuoto.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://networkconnectivity.googleapis.com/v1beta/projects/PROJECT/locations/LOCATION/transports/TRANSPORT_NAME

Sostituisci i seguenti valori:

• PROJECT: il nome del progetto
• LOCATION: la posizione in cui si trova la connessione
• TRANSPORT_NAME: il nome del trasporto che vuoi eliminare

Passaggi successivi

• Per trovare le risposte alle domande più comuni sull'architettura e sulle funzionalità di Cloud Interconnect, consulta le Domande frequenti su Cloud Interconnect.
• Per scoprire di più su Cloud Interconnect, consulta la panoramica di Cloud Interconnect.
• Per scoprire le best practice per la pianificazione e la configurazione di Cloud Interconnect, consulta Best practice.
• Per trovare i nomi delle risorse Google Cloud , consulta le API Cloud Interconnect.