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.

Sur les serveurs connectés Distributed Cloud, vous ne pouvez configurer des sous-réseaux qu'avec des ID de VLAN. Les sous-réseaux basés sur le CIDR ne sont pas compatibles avec les serveurs connectés Distributed Cloud.

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

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 connected n'autorise pas la réutilisation des ID de VLAN.
  • Pour que Distributed Cloud Connected attribue un ID de VLAN non utilisé 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 connectée Distributed Cloud.

Créer un sous-réseau

Pour créer un sous-réseau Distributed Cloud, suivez les étapes décrites dans cette section.

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

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 \
    --ipv6-range=IPV6_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.
  • IPV6_RANGE : plage d'adresses IPv6 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 Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone connectée Distributed Cloud 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,
   },
  "ipv6Cidr": { IPV6_RANGE,
   },       
  "vlanId": { VLAN_ID,
   },
 }

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet Google Cloud cible.
  • REGION : région Google Cloud à laquelle appartient la zone connectée Distributed Cloud cible.
  • ZONE_NAME : nom de la zone connectée Distributed Cloud 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.
  • IPV6_RANGE : plage d'adresses IPv6 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 lister les sous-réseaux provisionnés dans une zone connectée Distributed Cloud, suivez les étapes décrites dans cette section.

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

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 : région Google Cloud à laquelle appartient la zone connectée Distributed Cloud cible.
  • ZONE_NAME : nom de la zone connectée Distributed Cloud 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 du projet Google Cloud cible.
  • REGION : région Google Cloud à laquelle appartient la zone connectée Distributed Cloud cible.
  • ZONE_NAME : nom de la zone connectée Distributed Cloud 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 séparés par une virgule selon lesquels les résultats renvoyés sont triés. L'ordre de tri par défaut est croissant. Pour un ordre décroissant, ajoutez le préfixe ~ au champ souhaité.
  • PAGE_TOKEN : jeton reçu en 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 les étapes de cette section.

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

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 : région Google Cloud à laquelle appartient la zone connectée Distributed Cloud cible.
  • ZONE_NAME : nom de la zone connectée Distributed Cloud 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 du projet Google Cloud cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud connectée cible.
  • ZONE_NAME : nom de la zone connectée Distributed Cloud 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 d'approvisionnement :

  • 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 soit propagée dans toute la zone.
  • RUNNING : la ressource a été provisionnée et propagée avec succès dans toute la zone. Elle est prête à être utilisée.
  • FAILED : le provisionnement de la ressource n'a pas abouti. La ressource n'a pas été propagée dans la zone.

Supprimer un sous-réseau

Pour supprimer un sous-réseau Distributed Cloud, suivez les étapes décrites dans cette section.

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

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 Google Cloud à laquelle appartient la zone Distributed Cloud connectée cible.
  • ZONE_NAME : nom de la zone connectée Distributed Cloud 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 du projet Google Cloud cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud connectée cible.
  • ZONE_NAME : nom de la zone connectée Distributed Cloud cible.
  • SUBNETWORK_NAME : nom du sous-réseau cible.

Étapes suivantes