Interconnect-Anhänge erstellen und verwalten

Auf dieser Seite wird beschrieben, wie Sie Google Distributed Cloud Interconnect-Anhangressourcen in einer Distributed Cloud-Zone erstellen und verwalten.

Diese Funktion ist nur für Distributed Cloud-Racks verfügbar. Distributed Cloud-Server unterstützen keine Interconnect-Attachment-Ressourcen.

Weitere Informationen zu Distributed Cloud-Interconnect-Anhängen finden Sie unter Funktionsweise von Distributed Cloud.

Hinweis :Bei der Anleitung für die Google Cloud CLI auf dieser Seite wird davon ausgegangen, dass Sie Cloud Shell oder eine andere Umgebung verwenden, in der bash installiert ist.

Beachten Sie Folgendes:

• Wir empfehlen, einen Interconnect-Anhang und den zugehörigen Router gleichzeitig zu erstellen. Weitere Informationen finden Sie unter Router erstellen.
• Optional können Sie eine VLAN-ID angeben, mit der die Pakete getaggt werden, die den Interconnect-Anhang durchlaufen.
• Die VLAN-ID, die Sie für das Paket-Tagging angeben, ist lokal für den Interconnect-Anhang. Ein bestimmter Interconnect-Anhang gehört also nicht zur selben Layer 2-Domäne wie die Interconnect-Anhänge, die mit anderen Interconnects oder Subnetzwerken verknüpft sind, die nicht mit Interconnect-Anhängen verknüpft sind. Die für das Paket-Tagging angegebene VLAN-ID muss zwar für alle Interconnect-Anhänge, die für die Ziel-Interconnect-Verbindung erstellt wurden, eindeutig sein, kann aber für andere Interconnect-Verbindungen und für Subnetzwerke, die nicht mit einem Interconnect-Anhang verknüpft sind, wiederverwendet werden.

Interconnect-Anhang erstellen

Führen Sie die Schritte in diesem Abschnitt aus, um eine Distributed Cloud-Interconnect-Anlage zu erstellen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge Network Admin“ (roles/edgenetwork.admin) in Ihrem Google Cloud -Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking interconnects attachments dedicated create aus:

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

Ersetzen Sie Folgendes:

• ATTACHMENT_NAME: Ein aussagekräftiger Name, der diesen Interconnect-Anhang eindeutig identifiziert.
• INTERCONNECT_NAME: der Name des Interconnect, mit dem dieser Interconnect-Anhang verbunden ist.
• NETWORK_NAME: Der Name des Distributed Cloud-Netzwerks, für das diese Interconnect-Anhangressource bereitgestellt wird.
• REGION: die Google Cloud Region, zu der die Zielzone für Distributed Cloud gehört.
• ZONE_NAME: Der Name der Distributed Cloud-Zielzone.
• VLAN_ID (optional): Die VLAN-ID, mit der Pakete, die diesen Interconnect-Anhang durchlaufen, getaggt werden. Gültige Werte liegen zwischen 2 und 4095. Wenn Sie diesen Wert weglassen oder auf 0 setzen, werden die Pakete nicht getaggt.
• MTU_SIZE: Die Größe der maximalen Übertragungseinheit (MTU) für das Subnetzwerk, in dem dieser Interconnect-Anhang instanziiert wird. Gültige Werte sind 1500 und 9000.

API

Stellen Sie eine POST-Anfrage an die Methode 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,
   },       
 }   

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des ZielprojektsGoogle Cloud .
• REGION: die Google Cloud Region, zu der die Zielzone für Distributed Cloud gehört.
• ZONE_NAME: Der Name der Distributed Cloud-Zielzone.
• ATTACHMENT_ID: Eine ID, die diese Interconnect-Verbindung eindeutig identifiziert.
• LABELS: Eine Liste der Labels, die auf diese Interconnect-Anhangressource angewendet werden sollen.
• INTERCONNECT_NAME: der Name des Interconnect, mit dem dieser Interconnect-Anhang verbunden ist.
• NETWORK_NAME: das Netzwerk, für das diese Interconnect-Anhangressource verwendet wird.
• VLAN_ID: die VLAN-ID für das Subnetzwerk, das von diesem Interconnect-Anhang auf dem Router instanziiert wird. Gültige Werte liegen zwischen 2 und 4095. Bei einem Wert von 0 wird das Subnetzwerk als nicht getaggt konfiguriert.
• MTU_SIZE: Die Größe der maximalen Übertragungseinheit (MTU) für das Subnetzwerk, in dem dieser Interconnect-Anhang instanziiert wird. Gültige Werte sind 1.500 und 9.000.

Interconnect-Anhänge auflisten

Führen Sie die Schritte in diesem Abschnitt aus, um die Distributed Cloud Interconnect-Anhänge in einer Distributed Cloud-Zone aufzulisten.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge Network Viewer“ (roles/edgenetwork.viewer) in Ihrem Google Cloud -Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking interconnects attachments list aus:

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

Ersetzen Sie Folgendes:

• REGION: die Google Cloud Region, zu der die Zielzone für Distributed Cloud gehört.
• ZONE_NAME: Der Name der Distributed Cloud-Zielzone.

API

Stellen Sie eine GET-Anfrage an die Methode 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

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des ZielprojektsGoogle Cloud .
• REGION: die Google Cloud Region, zu der die Zielzone für Distributed Cloud gehört.
• ZONE_NAME: Der Name der Distributed Cloud-Zielzone.
• FILTER: Ein Ausdruck, der die zurückgegebenen Ergebnisse auf bestimmte Werte beschränkt.
• PAGE_SIZE: Die Anzahl der Ergebnisse, die pro Seite zurückgegeben werden sollen.
• SORT_BY: Eine durch Kommas getrennte Liste von Feldnamen, nach denen die zurückgegebenen Ergebnisse sortiert werden. Die Standardsortierreihenfolge ist aufsteigend. Wenn Sie eine absteigende Sortierreihenfolge verwenden möchten, stellen Sie dem gewünschten Feld ~ voran.
• PAGE_TOKEN: Ein Token, das in der Antwort auf die letzte Listenanfrage im Feld nextPageToken in der Antwort empfangen wurde. Senden Sie dieses Token, um die nächste Ergebnisseite zu empfangen.

Informationen zu einer Interconnect-Verbindung abrufen

Führen Sie die Schritte in diesem Abschnitt aus, um Informationen zu einer Distributed Cloud Interconnect-Anlage abzurufen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge Network Viewer“ (roles/edgenetwork.viewer) in Ihrem Google Cloud -Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking interconnects attachments describe aus:

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

Ersetzen Sie Folgendes:

• ATTACHMENT_NAME: der Name des Zielanhangs für die Interconnect-Verbindung.
• REGION: die Google Cloud Region, zu der die Zielzone für Distributed Cloud gehört.
• ZONE_NAME: Der Name der Distributed Cloud-Zielzone.

API

Stellen Sie eine GET-Anfrage an die Methode projects.locations.zones.interconnectAttachments.get:

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

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des ZielprojektsGoogle Cloud .
• ATTACHMENT_ID: der Name des Zielanhangs für die Interconnect-Verbindung.
• REGION: die Google Cloud Region, zu der die Zielzone für Distributed Cloud gehört.
• ZONE_NAME: Der Name der Distributed Cloud-Zielzone.

Dieser Vorgang gibt detaillierte Informationen zur Ressource zurück, einschließlich des Bereitstellungsstatus:

• PENDING: Die Bereitstellung der Ressource hat noch nicht begonnen und sie wurde noch nicht in der gesamten Zone weitergegeben.
• PROVISIONING: Die Ressource wird bereitgestellt. Sie müssen warten, bis sie in der gesamten Zone verfügbar ist.
• RUNNING: Die Ressource wurde erfolgreich bereitgestellt und in der gesamten Zone propagiert. Sie kann verwendet werden.
• FAILED: Die Bereitstellung der Ressource war nicht erfolgreich. Die Ressource wurde nicht in der gesamten Zone weitergegeben.

Interconnect-Anhang löschen

Führen Sie die Schritte in diesem Abschnitt aus, um eine Distributed Cloud-Interconnect-Anlage zu löschen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge Network Admin“ (roles/edgenetwork.admin) in Ihrem Google Cloud -Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking interconnects attachments delete aus:

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

Ersetzen Sie Folgendes:

• ATTACHMENT_NAME: der Name des Zielanhangs für die Interconnect-Verbindung.
• REGION: die Google Cloud Region, zu der die Zielzone für Distributed Cloud gehört.
• ZONE_NAME: Der Name der Distributed Cloud-Zielzone.

API

Stellen Sie eine DELETE-Anfrage an die Methode projects.locations.zones.interconnectAttachments.delete:

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

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des ZielprojektsGoogle Cloud .
• ATTACHMENT_NAME: der Name des Zielanhangs für die Interconnect-Verbindung.
• REGION: die Google Cloud Region, zu der die Zielzone für Distributed Cloud gehört.
• ZONE_NAME: Der Name der Distributed Cloud-Zielzone.

Nächste Schritte

• Arbeitslasten in Distributed Cloud bereitstellen
• Interconnects verwalten
• Netzwerke erstellen und verwalten
• Router erstellen und verwalten
• Subnetzwerke erstellen und verwalten
• VPN-Verbindungen erstellen und verwalten
• Zonen verwalten