Créer et gérer des sous-réseaux

Cette page explique comment créer et gérer des ressources de sous-réseau Google Distributed Cloud dans une zone connectée Distributed Cloud.

Pour en savoir plus sur les sous-réseaux Distributed Cloud, consultez la page Fonctionnement de Distributed Cloud connecté.

Tenez bien compte des éléments suivants :

  • Vous pouvez créer jusqu'à 138 sous-réseaux par zone Distributed Cloud.
  • Le sous-réseau est un VLAN au sein du réseau parent. Par conséquent, chaque sous-réseau doit disposer d'un ID de VLAN unique au niveau mondial. Distributed Cloud connecté n'autorise pas la réutilisation des ID de VLAN.
  • Pour que Distributed Cloud connecté attribue un ID de VLAN inutilisé de manière aléatoire, spécifiez 0 comme ID de VLAN lorsque vous créez le sous-réseau.
  • Le sous-réseau est accessible à tous les nœuds de votre zone Distributed Cloud connectée.

Créer un sous-réseau

Pour créer un sous-réseau Distributed Cloud, suivez la procédure décrite dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Administrateur de réseau Edge (roles/edgenetwork.admin) dans votre Google Cloud projet.

gcloud

Exécutez la commande 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

Remplacez les éléments suivants :

  • SUBNETWORK_NAME: nom descriptif qui identifie de manière unique ce sous-réseau.
  • NETWORK_NAME: réseau qui encapsule ce sous-réseau.
  • IPV4_RANGE: plage d'adresses IPv4 couverte par ce sous-réseau au format adresse IP/préfixe.
  • VLAN_ID : ID de VLAN cible pour ce sous-réseau.
  • REGION :région à laquelle appartient la zone Distributed Cloud cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connectée cible.

API

Envoyez une requête POST à la méthode 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,
   },
 }

Remplacez les éléments suivants :

  • PROJECT_ID : ID duprojet cible. Google Cloud
  • REGION: la Google Cloud région à laquelle appartient la zone Distributed Cloud connectée cible.
  • ZONE_NAME: nom de la zone Distributed Cloud connectée cible.
  • SUBNETWORK_ID: ID qui identifie de manière unique ce sous-réseau.
  • LABELS: liste des libellés à appliquer à cette ressource de sous-réseau.
  • NETWORK_NAME: réseau qui encapsule ce sous-réseau.
  • IPV4_RANGE: plage d'adresses IPv4 couverte par ce sous-réseau au format adresse IP/préfixe.
  • VLAN_ID : ID de VLAN cible pour ce sous-réseau.

Obtenir la liste des sous-réseaux

Pour répertorier les sous-réseaux provisionnés dans une zone Distributed Cloud connectée, suivez la procédure décrite dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Lecteur de réseau Edge (roles/edgenetwork.viewer) dans votre Google Cloud projet.

gcloud

Exécutez la commande gcloud edge-cloud networking subnets list :

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

Remplacez les éléments suivants :

  • REGION: la Google Cloud région à laquelle appartient la zone Distributed Cloud connectée cible.
  • ZONE_NAME: nom de la zone Distributed Cloud connectée cible.

API

Envoyez une requête GET à la méthode 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

Remplacez les éléments suivants :

  • PROJECT_ID : ID duprojet cible. Google Cloud
  • REGION: la Google Cloud région à laquelle appartient la zone Distributed Cloud connectée cible.
  • ZONE_NAME: nom de la zone Distributed Cloud connectée cible.
  • FILTER: expression qui limite les résultats renvoyés à des valeurs spécifiques.
  • PAGE_SIZE : nombre de résultats à renvoyer par page.
  • SORT_BY: liste de noms de champs selon lesquels les résultats renvoyés sont triés, séparés par une virgule. L'ordre de tri par défaut est croissant. Pour un ordre décroissant, faites précéder le champ souhaité de ~.
  • PAGE_TOKEN: jeton reçu dans la réponse à la dernière requête de liste dans le champ nextPageToken de la réponse. Envoyez ce jeton pour recevoir une page de résultats.

Obtenir des informations sur un sous-réseau

Pour obtenir des informations sur un sous-réseau Distributed Cloud, suivez la procédure décrite dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Lecteur de réseau Edge (roles/edgenetwork.viewer) dans votre Google Cloud projet.

gcloud

Exécutez la commande gcloud edge-cloud networking subnets describe :

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

Remplacez les éléments suivants :

  • SUBNETWORK_NAME : nom du sous-réseau cible.
  • REGION: la Google Cloud région à laquelle appartient la zone Distributed Cloud connectée cible.
  • ZONE_NAME: nom de la zone Distributed Cloud connectée cible.

API

Envoyez une requête GET à la méthode projects.locations.zones.subnets.get :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID duprojet cible. Google Cloud
  • REGION: région à laquelle appartient la zone Distributed Cloud connectée cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connectée cible.
  • SUBNETWORK_NAME : nom du sous-réseau cible.

Cette opération renvoie des informations détaillées sur la ressource, y compris son état de provisionnement :

  • PENDING: le provisionnement de la ressource n'a pas encore commencé et elle n'a pas encore été propagée dans toute la zone.
  • PROVISIONING: la ressource est en cours de provisionnement. Vous devez attendre qu'elle ait été propagée dans toute la zone.
  • RUNNING: la ressource a été provisionnée et propagée dans toute la zone. Elle est prête à être utilisée.
  • FAILED: le provisionnement de la ressource a échoué. La ressource n'a pas été propagée dans toute la zone.

Supprimer un sous-réseau

Pour supprimer un sous-réseau Distributed Cloud, suivez la procédure décrite dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Administrateur de réseau Edge (roles/edgenetwork.admin) dans votre Google Cloud projet.

gcloud

Exécutez la commande gcloud edge-cloud networking subnets delete :

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

Remplacez les éléments suivants :

  • SUBNETWORK_NAME : nom du sous-réseau cible.
  • REGION: région à laquelle appartient la zone Distributed Cloud connectée cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connectée cible.

API

Envoyez une requête DELETE à la méthode projects.locations.zones.subnets.delete :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID duprojet cible. Google Cloud
  • REGION: région à laquelle appartient la zone Distributed Cloud connectée cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connectée cible.
  • SUBNETWORK_NAME : nom du sous-réseau cible.

Étape suivante