Créer et gérer des réseaux

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

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

Tenez bien compte des éléments suivants :

  • Vous pouvez créer jusqu'à 20 réseaux par zone Distributed Cloud.
  • Un réseau est un réseau privé virtuel instancié dans la zone cible.
  • Le réseau est instancié en tant que fonction de routage virtuel (VRF).
  • Les paquets sont acheminés indépendamment à l'intérieur d'un réseau.

Créer un réseau

Pour créer un 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 networks create :

gcloud edge-cloud networking networks create NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --mtu=MTU_SIZE

Remplacez les éléments suivants :

  • NETWORK_NAME : nom descriptif qui identifie de manière unique ce réseau.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.
  • MTU_SIZE : taille de l'unité de transmission maximale (MTU) pour ce réseau. Les valeurs valides sont 1 500 et 9 000. Cette valeur doit correspondre à la taille de la MTU du réseau default et être identique pour tous les réseaux.

API

Envoyez une requête POST à la méthode projects.locations.zones.networks.create :

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks?networkId=NETWORK_ID
{
 "labels": { LABELS,
  },
 "mtu": { MTU_SIZE,
  },
}

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet Google Cloud cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.
  • NETWORK_ID : ID unique qui identifie ce réseau.
  • LABELS : liste des libellés à appliquer à cette ressource réseau.
  • MTU_SIZE : taille de l'unité de transmission maximale (MTU) pour ce réseau. Les valeurs valides sont 1 500 et 9 000.

Obtenir la liste des réseaux

Pour lister les réseaux Distributed Cloud provisionnés dans une zone 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 networks list :

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

Remplacez les éléments suivants :

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

API

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

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks?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 Distributed Cloud cible.
  • ZONE_NAME : nom de la zone 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 réseau

Pour obtenir des informations sur un 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 networks describe :

gcloud edge-cloud networking networks describe NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • NETWORK_NAME : nom du réseau cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.

API

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

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_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 cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.
  • NETWORK_ID : ID du réseau cible.

Vérifier l'état opérationnel d'un réseau

Pour vérifier l'état opérationnel d'un 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 networks get-status :

gcloud edge-cloud networking networks get-status NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • NETWORK_NAME : nom du réseau cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.

API

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

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID:diagnose

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet Google Cloud cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.
  • NETWORK_ID : ID du réseau cible.

Supprimer un réseau

Pour supprimer un 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 networks delete :

gcloud edge-cloud networking networks delete NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • NETWORK_NAME : nom du réseau cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.

API

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

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_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 cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.
  • NETWORK_ID : ID du réseau cible.

Étapes suivantes