Creare e gestire subnet

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

Per saperne di più sulle subnet di Distributed Cloud, consulta la pagina Come funziona Distributed Cloud connected.

Tieni presente che:

  • Puoi creare fino a 138 subnet per zona Distributed Cloud.
  • La subnet è una rete VLAN all'interno della rete principale. Pertanto, ogni subnet deve avere un ID VLAN univoco a livello globale. Distributed Cloud connected non consente il riutilizzo degli ID VLAN.
  • Per fare in modo che Distributed Cloud connected assegni un ID VLAN non utilizzato in modo casuale, specifica 0 come ID VLAN quando crei la subnet.
  • La subnet è accessibile a tutti i nodi nella zona Distributed Cloud connected.

Crea una subnet

Per creare una subnet di Distributed Cloud, completa i passaggi descritti in questa sezione.

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

gcloud

Utilizza il comando gcloud edge-cloud networking subnets create:

gcloud edge-cloud networking subnets create SUBNETWORK_NAME \
    --network=NETWORK_NAME \
    --ipv4-range=IPV4_RANGE \
    --vlan-id=VLAN_ID \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

  • SUBNETWORK_NAME: un nome descrittivo che identifica in modo univoco questa subnet.
  • NETWORK_NAME: la rete che incapsula questa subnet.
  • IPV4_RANGE: l'intervallo di indirizzi IPv4 coperto da questa subnet nel formato indirizzo IP/prefisso.
  • VLAN_ID: l'ID VLAN di destinazione per questa subnet.
  • REGION: la Google Cloud regione a cui appartiene la zona Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connected di destinazione.

API

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

 POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets?subnetId=SUBNETWORK_ID
 {
  "labels": { LABELS,
   },
  "network": { NETWORK_NAME,
   },
  "ipv4Cidr": { IPV4_RANGE,
   },
  "vlanId": { VLAN_ID,
   },
 }

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 connected di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connected di destinazione.
  • SUBNETWORK_ID: un ID che identifica in modo univoco questa subnet.
  • LABELS: un elenco di etichette da applicare a questa risorsa subnet.
  • NETWORK_NAME: la rete che incapsula questa subnet.
  • IPV4_RANGE: l'intervallo di indirizzi IPv4 coperto da questa subnet nel formato indirizzo IP/prefisso.
  • VLAN_ID: l'ID VLAN di destinazione per questa subnet.

Elenca subnet

Per elencare le subnet di cui è stato eseguito il provisioning all'interno di una zona Distributed Cloud connected, completa i passaggi descritti in questa sezione.

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

gcloud

Utilizza il comando gcloud edge-cloud networking subnets list:

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

Sostituisci quanto segue:

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

API

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

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets?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 connected di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connected 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, 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 una pagina di risultati.

Recupera informazioni su una subnet

Per recuperare informazioni su una subnet di Distributed Cloud, completa i passaggi descritti in questa sezione.

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

gcloud

Utilizza il comando gcloud edge-cloud networking subnets describe:

gcloud edge-cloud networking subnets describe SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

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

API

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

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

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

  • PENDING: il provisioning della risorsa non è ancora iniziato e 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: è stato eseguito il provisioning della risorsa e questa è 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.

Elimina una subnet

Per eliminare una subnet di Distributed Cloud, completa i passaggi descritti in questa sezione.

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

gcloud

Utilizza il comando gcloud edge-cloud networking subnets delete:

gcloud edge-cloud networking subnets delete SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Sostituisci quanto segue:

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

API

Invia una richiesta DELETE al metodo projects.locations.zones.subnets.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
  • REGION: la Google Cloud regione a cui appartiene la zona Distributed Cloud connected di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud connected di destinazione.
  • SUBNETWORK_NAME: il nome della subnet di destinazione.

Passaggi successivi