Creare e gestire i collegamenti di interconnessione

Questa pagina descrive come creare e gestire le risorse di collegamento di interconnessione Google Distributed Cloud in una zona connessa a Distributed Cloud.

Questa funzionalità è disponibile solo sui rack connessi a Distributed Cloud. I server connessi a Distributed Cloud non supportano le risorse di collegamento di interconnessione.

Per saperne di più sui collegamenti di interconnessione Distributed Cloud, vedi Come funziona Distributed Cloud.

Tieni presente che:

  • Ti consigliamo di creare un collegamento di interconnessione e il router corrispondente contemporaneamente. Per saperne di più, vedi Creare un router.
  • Facoltativamente, puoi specificare un ID VLAN da utilizzare per taggare i pacchetti che passano attraverso il collegamento di interconnessione.
  • L'ID VLAN specificato per il tagging dei pacchetti è locale al collegamento di interconnessione. In altre parole, un determinato collegamento di interconnessione non fa parte dello stesso dominio di livello 2 dei collegamenti di interconnessione associati ad altre interconnessioni o sottoreti non associate ad alcun collegamento di interconnessione. Pertanto, anche se l'ID VLAN specificato per il tagging dei pacchetti deve essere univoco in tutti i collegamenti di interconnessione creati sull'interconnessione di destinazione, può essere riutilizzato su altre interconnessioni e su sottoreti non associate a un collegamento di interconnessione.

Creare un collegamento di interconnessione

Per creare un collegamento di interconnessione Distributed Cloud, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi avere il ruolo Amministratore della rete Edge (roles/edgenetwork.admin) nel tuo Google Cloud progetto.

gcloud

Utilizza il comando gcloud edge-cloud networking interconnects attachments dedicated create:

gcloud edge-cloud networking interconnects attachments dedicated create ATTACHMENT_NAME \
    --interconnect=INTERCONNECT_NAME \
    --network=NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --vlan-id=VLAN_ID \
    --mtu=MTU_SIZE

Sostituisci quanto segue:

  • ATTACHMENT_NAME: un nome descrittivo che identifica in modo univoco questo collegamento di interconnessione.
  • INTERCONNECT_NAME: il nome dell'interconnessione a cui si connette questo collegamento di interconnessione.
  • NETWORK_NAME: il nome della rete Distributed Cloud a cui è destinata questa risorsa di collegamento di interconnessione.
  • REGION: la Google Cloud regione a cui appartiene la zona Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud di destinazione.
  • VLAN_ID (facoltativo): l'ID VLAN con cui vengono taggati i pacchetti che passano attraverso questo collegamento di interconnessione. I valori validi sono compresi tra 2 e 4095. Se ometti questo valore o lo imposti su 0, i pacchetti non vengono taggati.
  • MTU_SIZE: la dimensione dell'unità massima di trasmissione (MTU) per la sottorete di cui viene creata un'istanza da questo collegamento di interconnessione. I valori validi sono 1500 e 9000.

API

Invia una richiesta POST al metodo projects.locations.zones.interconnectAttachments.create:

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments?interconnectAttachmentId=ATTACHMENT_ID
 {
  "labels": { LABELS,
   },
  "interconnect": { INTERCONNECT_NAME,
   },
  "network": { NETWORK_NAME,
   },
  "vlanId": { VLAN_ID,
   },
  "mtu": { MTU_SIZE,
   },       
 }

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto di destinazione Google Cloud .
  • REGION: la Google Cloud regione a cui appartiene la zona Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud di destinazione.
  • ATTACHMENT_ID: un ID che identifica in modo univoco questo collegamento di interconnessione.
  • LABELS: un elenco di etichette da applicare a questa risorsa di collegamento di interconnessione.
  • INTERCONNECT_NAME: il nome dell'interconnessione a cui si connette questo collegamento di interconnessione.
  • NETWORK_NAME: la rete a cui è destinata questa risorsa di collegamento di interconnessione.
  • VLAN_ID: l'ID VLAN per la sottorete di cui viene creata un'istanza da questo collegamento di interconnessione sul router. I valori validi sono compresi tra 2 e 4095. Un valore pari a 0 configura la sottorete come non taggata.
  • MTU_SIZE: la dimensione dell'unità massima di trasmissione (MTU) per la sottorete di cui viene creata un'istanza da questo collegamento di interconnessione. I valori validi sono 1500 e 9000.

Elencare i collegamenti di interconnessione

Per elencare i collegamenti di interconnessione Distributed Cloud in una zona connessa a Distributed Cloud, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi avere il ruolo Visualizzatore della rete Edge (roles/edgenetwork.viewer) nel tuo Google Cloud progetto.

gcloud

Utilizza il comando gcloud edge-cloud networking interconnects attachments list:

gcloud edge-cloud networking interconnects attachments list \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • REGION: la Google Cloud regione a cui appartiene la zona connessa a Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud di destinazione.

API

Invia una richiesta GET al metodo projects.locations.zones.interconnectAttachments.list:

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto di destinazione Google Cloud .
  • REGION: la Google Cloud regione a cui appartiene la zona Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud di destinazione.
  • FILTER: un'espressione che vincola i risultati restituiti a valori specifici.
  • PAGE_SIZE: il numero di risultati da restituire per pagina.
  • SORT_BY: un elenco di nomi di campi separati da virgole in base ai quali vengono ordinati i risultati restituiti. L'ordinamento predefinito è crescente; per l'ordinamento decrescente, anteponi il campo desiderato con ~.
  • PAGE_TOKEN: un token ricevuto nella risposta all'ultima richiesta di elenco nel campo nextPageToken della risposta. Invia questo token per ricevere la pagina successiva di risultati.

Ottenere informazioni su un collegamento di interconnessione

Per ottenere informazioni su un collegamento di interconnessione Distributed Cloud, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi avere il ruolo Visualizzatore della rete Edge (roles/edgenetwork.viewer) nel tuo Google Cloud progetto.

gcloud

Utilizza il comando gcloud edge-cloud networking interconnects attachments describe:

gcloud edge-cloud networking interconnects attachments describe ATTACHMENT_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • ATTACHMENT_NAME: il nome del collegamento di interconnessione di destinazione.
  • REGION: la Google Cloud regione a cui appartiene la zona connessa a Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud di destinazione.

API

Invia una richiesta GET al metodo projects.locations.zones.interconnectAttachments.get:

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments/ATTACHMENT_ID

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto di destinazione Google Cloud .
  • ATTACHMENT_ID: il nome del collegamento di interconnessione di destinazione.
  • REGION: la Google Cloud regione a cui appartiene la zona connessa a Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud di destinazione.

Questa operazione restituisce informazioni dettagliate sulla risorsa, incluso il relativo stato di provisioning, come segue:

  • PENDING: il provisioning della risorsa non è ancora iniziato e la risorsa non è ancora stata propagata in tutta la zona.
  • PROVISIONING: è in corso il provisioning della risorsa; devi attendere che sia stata propagata in tutta la zona.
  • RUNNING: il provisioning della risorsa è stato eseguito correttamente e la risorsa è stata propagata in tutta la zona; è pronta per l'uso.
  • FAILED: il provisioning della risorsa non è andato a buon fine; la risorsa non è stata propagata in tutta la zona.

Eliminare un collegamento di interconnessione

Per eliminare un collegamento di interconnessione Distributed Cloud, completa i passaggi descritti in questa sezione.

Per completare questa attività, devi avere il ruolo Amministratore della rete Edge (roles/edgenetwork.admin) nel tuo Google Cloud progetto.

gcloud

Utilizza il comando gcloud edge-cloud networking interconnects attachments delete:

gcloud edge-cloud networking interconnects attachments delete ATTACHMENT_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • ATTACHMENT_NAME: il nome del collegamento di interconnessione di destinazione.
  • REGION: la Google Cloud regione a cui appartiene la zona connessa a Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud di destinazione.

API

Invia una richiesta DELETE al metodo projects.locations.zones.interconnectAttachments.delete:

DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets/SUBNETWORK_ID

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto di destinazione Google Cloud .
  • ATTACHMENT_NAME: il nome del collegamento di interconnessione di destinazione.
  • REGION: la Google Cloud regione a cui appartiene la zona connessa a Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona connessa a Distributed Cloud di destinazione.

Passaggi successivi