Creare e gestire subnet

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

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

Tieni presente che:

  • Puoi creare fino a 20 subnet all'interno di ogni rete.
  • La subnet è una rete VLAN all'interno della rete principale. Pertanto, ogni subnet deve avere un ID VLAN univoco a livello globale. Distributed Cloud non consente il riutilizzo degli ID VLAN.
  • Per fare in modo che Distributed Cloud 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 tua zona Distributed Cloud.

Crea una sottorete

Per creare una subnet 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 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 regione Google Cloud a cui appartiene la zona Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud 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 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.
  • SUBNETWORK_ID: un ID che identifica in modo univoco questa subnet.
  • LABELS: un elenco di etichette da applicare a questa risorsa di 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 provisionate all'interno di una zona 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 subnets list:

gcloud edge-cloud networking subnets 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

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 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 una pagina di risultati.

Ottenere informazioni su una subnet

Per ottenere informazioni su una subnet 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 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 regione Google Cloud a cui appartiene la zona Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud 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 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.
  • 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 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 una sottorete

Per eliminare una subnet Distributed Cloud, completa i passaggi 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 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 regione Google Cloud a cui appartiene la zona Distributed Cloud di destinazione.
  • ZONE_NAME: il nome della zona Distributed Cloud 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 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.
  • SUBNETWORK_NAME: il nome della subnet di destinazione.

Passaggi successivi