Créer et gérer des rattachements d'interconnexion

Cette page explique comment créer et gérer des ressources de rattachement d'interconnexion Google Distributed Cloud dans une zone connectée Distributed Cloud.

Cette fonctionnalité n'est disponible que sur les racks connectés Distributed Cloud. Les serveurs connectés Distributed Cloud ne sont pas compatibles avec les ressources de rattachement d'interconnexion.

Pour en savoir plus sur les rattachements d'interconnexion Distributed Cloud, consultez Fonctionnement de Distributed Cloud.

Tenez bien compte des éléments suivants :

  • Nous vous recommandons de créer un rattachement d'interconnexion en même temps que le routeur correspondant. Pour en savoir plus, consultez Créer un routeur.
  • Vous pouvez éventuellement spécifier un ID de VLAN à utiliser pour ajouter un tag aux paquets qui transitent par le rattachement d'interconnexion.
  • L'ID de VLAN que vous spécifiez pour l'ajout de tags aux paquets est local au rattachement d'interconnexion. En d'autres termes, un rattachement d'interconnexion donné ne fait pas partie du même domaine de couche 2 que les rattachements d'interconnexion associés à d'autres interconnexions, ni des sous-réseaux qui ne sont associés à aucun rattachement d'interconnexion. Par conséquent, bien que l'ID de VLAN spécifié pour l'ajout de tags aux paquets doive être unique pour tous les rattachements d'interconnexion créés sur l'interconnexion cible, il peut être réutilisé sur d'autres interconnexions et sur des sous-réseaux non associés à un rattachement d'interconnexion.

Créer un rattachement d'interconnexion

Pour créer un rattachement d'interconnexion Distributed Cloud, suivez les étapes de 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 interconnects attachments dedicated create :

gcloud edge-cloud networking interconnects attachments dedicated create ATTACHMENT_NAME \
    --interconnect=INTERCONNECT_NAME \
    --network=NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --vlan-id=VLAN_ID \
    --mtu=MTU_SIZE

Remplacez les éléments suivants :

  • ATTACHMENT_NAME: nom descriptif qui identifie de manière unique ce rattachement d'interconnexion.
  • INTERCONNECT_NAME: nom de l'interconnexion à laquelle ce rattachement d'interconnexion se connecte.
  • NETWORK_NAME: nom du réseau Distributed Cloud que cette ressource de rattachement d'interconnexion dessert.
  • REGION : région à laquelle appartient la zone Distributed Cloud cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud cible.
  • VLAN_ID (facultatif) : ID de VLAN avec lequel les paquets qui transitent par ce rattachement d'interconnexion sont balisés. Les valeurs valides sont comprises entre 2 et 4095. Si vous omettez cette valeur ou la définissez sur 0, les paquets ne sont pas balisés.
  • MTU_SIZE: taille de l'unité de transmission maximale (MTU) pour le sous-réseau que ce rattachement d'interconnexion instancie. Les valeurs valides sont 1500 et 9000.

API

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

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments?interconnectAttachmentId=ATTACHMENT_ID
 {
  "labels": { LABELS,
   },
  "interconnect": { INTERCONNECT_NAME,
   },
  "network": { NETWORK_NAME,
   },
  "vlanId": { VLAN_ID,
   },
  "mtu": { MTU_SIZE,
   },       
 }

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet cible Google Cloud .
  • REGION : région à laquelle appartient la zone Distributed Cloud cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud cible.
  • ATTACHMENT_ID: ID qui identifie de manière unique ce rattachement d'interconnexion.
  • LABELS: liste de libellés à appliquer à cette ressource de rattachement d'interconnexion.
  • INTERCONNECT_NAME: nom de l'interconnexion à laquelle ce rattachement d'interconnexion se connecte.
  • NETWORK_NAME: réseau que cette ressource de rattachement d'interconnexion dessert.
  • VLAN_ID: ID de VLAN pour le sous-réseau que ce rattachement d'interconnexion instancie sur le routeur. Les valeurs valides sont comprises entre 2 et 4095. La valeur 0 configure le sous-réseau comme non balisé.
  • MTU_SIZE: taille de l'unité de transmission maximale (MTU) pour le sous-réseau que ce rattachement d'interconnexion instancie. Les valeurs valides sont 1500 et 9000.

Obtenir la liste des pièces jointes d'interconnexion

Pour répertorier les rattachements d'interconnexion Distributed Cloud dans une zone connectée 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 Google Cloud projet.

gcloud

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

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

Remplacez les éléments suivants :

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

API

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

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet cible Google Cloud .
  • REGION : région à laquelle appartient la zone Distributed Cloud cible. Google Cloud
  • 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 de tri 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 la page de résultats suivante.

Obtenir des informations sur un rattachement d'interconnexion

Pour obtenir des informations sur un rattachement d'interconnexion 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 Google Cloud projet.

gcloud

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

gcloud edge-cloud networking interconnects attachments describe ATTACHMENT_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • ATTACHMENT_NAME: nom du rattachement d'interconnexion cible.
  • REGION : région à laquelle appartient la zone connectée Distributed Cloud cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud cible.

API

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

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments/ATTACHMENT_ID

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet cible Google Cloud .
  • ATTACHMENT_ID: nom du rattachement d'interconnexion cible.
  • REGION : région à laquelle appartient la zone connectée Distributed Cloud cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud cible.

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

  • 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 rattachement d'interconnexion

Pour supprimer un rattachement d'interconnexion Distributed Cloud, suivez les étapes de 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 interconnects attachments delete :

gcloud edge-cloud networking interconnects attachments delete ATTACHMENT_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • ATTACHMENT_NAME: nom du rattachement d'interconnexion cible.
  • REGION : région à laquelle appartient la zone connectée Distributed Cloud cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud cible.

API

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

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet cible Google Cloud .
  • ATTACHMENT_NAME: nom du rattachement d'interconnexion cible.
  • REGION : région à laquelle appartient la zone connectée Distributed Cloud cible. Google Cloud
  • ZONE_NAME: nom de la zone connectée Distributed Cloud cible.

Étape suivante