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

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

Cette fonctionnalité n'est disponible que sur les racks Distributed Cloud. Les serveurs Distributed Cloud ne sont pas compatibles avec les ressources d'attachement Interconnect.

Pour en savoir plus sur les pièces jointes Distributed Cloud Interconnect, consultez Fonctionnement de Distributed Cloud.

Tenez bien compte des éléments suivants :

  • Nous vous recommandons de créer un rattachement d'interconnexion et le routeur correspondant en même temps. Pour en savoir plus, consultez Créer un routeur.
  • Vous pouvez éventuellement spécifier un ID de VLAN à utiliser pour taguer les paquets qui transitent par le rattachement d'interconnexion.
  • L'ID de VLAN que vous spécifiez pour le taggage de 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 le taggage de 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éseaux Edge (roles/edgenetwork.admin) dans votre projet Google Cloud .

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 auquel cette ressource d'association Interconnect est associée.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • 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 tagués. Les valeurs valides sont comprises entre 2 et 4 095. Si vous omettez cette valeur ou la définissez sur 0, les paquets ne sont pas tagués.
  • MTU_SIZE : taille de l'unité de transmission maximale (MTU) pour la sous-réseau que ce rattachement d'interconnexion instancie. Les valeurs valides sont 1 500 et 9 000.

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 projetGoogle Cloud cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.
  • ATTACHMENT_ID : ID qui identifie de manière unique ce rattachement d'interconnexion.
  • LABELS : liste des 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 desservi par cette ressource d'association d'interconnexion.
  • VLAN_ID : ID de VLAN du sous-réseau que ce rattachement d'interconnexion instancie sur le routeur. Les valeurs valides sont comprises entre 2 et 4 095. Une valeur de 0 configure le sous-réseau comme non tagué.
  • MTU_SIZE : taille de l'unité de transmission maximale (MTU) pour la sous-réseau que ce rattachement d'interconnexion instancie. Les valeurs valides sont 1 500 et 9 000.

Obtenir la liste des pièces jointes d'interconnexion

Pour lister les rattachements d'interconnexion Distributed Cloud 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 interconnects attachments list :

gcloud edge-cloud networking interconnects attachments 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.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 projetGoogle 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 la page de résultats suivante.

Obtenir des informations sur une pièce jointe d'interconnexion

Pour obtenir des informations sur un rattachement Distributed Cloud Interconnect, 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 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 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.interconnectAttachments.get :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projetGoogle Cloud cible.
  • ATTACHMENT_ID : nom du rattachement d'interconnexion cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • 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 d'approvisionnement, 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 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 rattachement d'interconnexion

Pour supprimer une pièce jointe d'interconnexion 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 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 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.interconnectAttachments.delete :

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

Remplacez les éléments suivants :

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

Étapes suivantes