Creare e gestire i collegamenti di interconnessione

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

Per saperne di più sugli allegati di interconnessione Distributed Cloud, consulta Come funziona Distributed Cloud.

Tieni presente che:

  • Ti consigliamo di creare un collegamento di interconnessione insieme al router corrispondente contemporaneamente. Per ulteriori informazioni, vedi Creare un router.
  • Puoi anche 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 per il 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 che non sono associate ad alcun collegamento di interconnessione. Pertanto, mentre 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 subnet non associate a un collegamento di interconnessione.

Crea un collegamento di interconnessione

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

Per completare questa attività, devi disporre del ruolo Edge Network Admin (roles/edgenetwork.admin) nel tuo progetto Google Cloud .

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 interconnessione.
  • NETWORK_NAME: il nome della rete Distributed Cloud a cui serve questa risorsa di collegamento interconnessione.
  • REGION: la regione Google Cloud 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 subnet di cui viene creata un'istanza da questo collegamento di interconnessione. I valori validi sono 1500 e 9000.

API

Effettua 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 Google Cloud di destinazione.
  • REGION: la regione Google Cloud 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 interconnect.
  • INTERCONNECT_NAME: il nome dell'interconnessione a cui si connette questo collegamento interconnessione.
  • NETWORK_NAME: la rete a cui serve questa risorsa di collegamento interconnect.
  • VLAN_ID: l'ID VLAN per la subnet che questo collegamento di interconnessione crea sul router. I valori validi sono compresi tra 2 e 4095. Un valore pari a 0 configura la subnet come non taggata.
  • MTU_SIZE: la dimensione dell'unità massima di trasmissione (MTU) per la subnet di cui viene creata un'istanza da questo collegamento di interconnessione. I valori validi sono 1500 e 9000.

Elenca collegamenti di interconnessione

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

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

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 regione Google Cloud a cui appartiene la zona Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud di destinazione.

API

Effettua 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 Google Cloud di destinazione.
  • REGION: la regione Google Cloud 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 delimitato da virgole di nomi di campi in base ai quali vengono ordinati i risultati restituiti. L'ordinamento predefinito è crescente. Per l'ordinamento decrescente, aggiungi il prefisso ~ al campo desiderato.
  • 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 dei risultati.

Recuperare informazioni su un collegamento di interconnessione

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

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

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 dell'allegato interconnect di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud di destinazione.

API

Effettua 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 Google Cloud di destinazione.
  • ATTACHMENT_ID: il nome dell'allegato interconnect di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona 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: la risorsa è in fase di provisioning; devi attendere che sia stata propagata in tutta la zona.
  • RUNNING: la risorsa è stata sottoposta a provisioning e propagata correttamente in tutta la zona ed è pronta per l'uso.
  • FAILED: il provisioning della risorsa non è andato a buon fine; la risorsa non è stata propagata in tutta la zona.

Elimina un collegamento di interconnessione

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

Per completare questa attività, devi disporre del ruolo Edge Network Admin (roles/edgenetwork.admin) nel tuo progetto Google Cloud .

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 dell'allegato interconnect di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud di destinazione.

API

Effettua 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 Google Cloud di destinazione.
  • ATTACHMENT_NAME: il nome dell'allegato interconnect di destinazione.
  • REGION: la regione Google Cloud a cui appartiene la zona Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud di destinazione.

Passaggi successivi