Externe IPv4-Adresse in ein anderes Projekt verschieben

Vorschau

Dieses Produkt oder Feature unterliegt den Nutzungsbedingungen für Pre-GA-Angebote der Google Cloud-Nutzungsbedingungen. Pre-GA-Produkte und -Funktionen werden möglicherweise nur eingeschränkt unterstützt und Änderungen an Pre-GA-Produkten und -Funktionen sind möglicherweise nicht mit anderen Pre-GA-Versionen kompatibel. Weitere Informationen finden Sie in der Beschreibung der Startphase.

Statische externe IPv4-Adressen sind einem Google Cloud-Projekt zugeordnet und können nur innerhalb dieses Projekts verwendet werden. Sie können jedoch eine statische externe IPv4-Adresse von einem Projekt in ein anderes verschieben.

IAM-Rollen und -Berechtigungen

Zum Verschieben einer regionalen IP-Adresse benötigen Sie die folgenden Berechtigungen:

• compute.addresses.delete im Quellprojekt
• compute.addresses.create im Zielprojekt

Zum Verschieben einer globalen IP-Adresse benötigen Sie die folgenden Berechtigungen:

• compute.globalAddresses.delete im Quellprojekt
• compute.globalAddresses.create im Zielprojekt

Beispielrollen mit diesen Berechtigungen:

• Compute-Administrator (roles/compute.admin)
• Compute-Netzwerkadministrator (roles/compute.networkAdmin)
• Administrator öffentlicher IP-Adressen für Compute Engine (roles/compute.publicIpAdmin)

Hinweis

• Prüfen Sie, ob das Projekt vorhanden ist, in das Sie die IP-Adresse verschieben möchten. Wenn nicht, erstellen Sie ein Projekt.

• Aktivieren Sie die Compute Engine API im Zielprojekt.

• Prüfen Sie, ob das Zielprojekt über genügend Kapazität im entsprechenden Kontingent für die IP-Adresse verfügt, die Sie verschieben möchten:

  • Prüfen Sie für regionale externe IP-Adressen das Kontingent für statische IP-Adressen.
  • Prüfen Sie für globale externe IP-Adressen das globale Kontingent für statische IP-Adressen.

• Prüfen Sie, ob die IP-Adresse, die Sie verschieben möchten, die folgenden Attribute hat:

  • Der Zugriffstyp ist extern.
  • Die IP-Version ist IPv4.

  • Die IP-Adresse ist reserviert, nicht sitzungsspezifisch.

    Informationen zum Reservieren einer IP-Adresse finden Sie unter Neue statische externe IP-Adresse reservieren.

  • Die IP-Adresse wird von keiner Ressource verwendet, z. B. einer VM-Instanz oder einer Weiterleitungsregel.

    Informationen zum Aufheben der Zuweisung einer IP-Adresse finden Sie unter Zuweisung einer statischen externen IP-Adresse aufheben.

Beschränkungen

• Sie können eine einzelne IP-Adresse pro Projekt, Standort und Minute verschieben.

  Beispiel:

  • Sie können eine einzelne globale IP-Adresse pro Projekt und Minute verschieben.
  • Sie können eine einzelne regionale IP-Adresse in us-central1 pro Minute verschieben.

• Wenn Sie die Zuweisung einer IP-Adresse aufheben, müssen Sie einige Zeit warten, bevor Sie sie verschieben:

  • Warten Sie bei globalen IP-Adressen 10 Minuten.
  • Warten Sie bei regionalen IP-Adressen 20 Minuten.

Externe IPv4-Adresse in ein anderes Projekt verschieben

Sie können eine regionale oder globale externe IPv4-Adresse von einem Projekt in ein anderes verschieben. Wenn Sie die IP-Adresse verschieben, wird der Ressource standardmäßig derselbe Name und dieselbe Beschreibung zugewiesen. Sie können jedoch einen neuen Namen oder eine neue Beschreibung zuweisen. Die Region regionaler Adressen kann nicht geändert werden.

Wichtig: Während der Vorschau müssen Sie den Befehl gcloud alpha compute addresses move verwenden, um eine Adresse zu verschieben. Wenn Sie die Fehlermeldung erhalten, die besagt, dass Sie 'Alpha Access' benötigen, wenden Sie sich an Ihren Vertriebsmitarbeiter oder an den Support.

gcloud

Die Befehlsoptionen hängen davon ab, ob Sie eine regionale oder globale IP-Adresse verschieben und ob Sie den Adressnamen und die Beschreibung beibehalten oder ersetzen. In den folgenden Beispielen werden einige dieser Kombinationen beschrieben.

• Regionale externe IPv4-Adresse in ein anderes Projekt verschieben:

  gcloud alpha compute addresses move ADDRESS_NAME \
      --target-project=TARGET_PROJECT \
      --region=REGION
  

• Regionale externe IPv4-Adresse in ein anderes Projekt verschieben und ihr einen neuen Namen und eine neue Beschreibung im neuen Projekt zuweisen:

  gcloud alpha compute addresses move ADDRESS_NAME \
      --target-project=TARGET_PROJECT \
      --new-name=NEW_NAME \
      --description=NEW_DESCRIPTION \
      --region=REGION
  

• Globale externe IPv4-Adresse in ein anderes Projekt verschieben:

  gcloud alpha compute addresses move ADDRESS_NAME \
      --target-project=TARGET_PROJECT \
      --global
  

Dabei gilt:

• ADDRESS_NAME: der Name der IP-Adressressource, die Sie verschieben möchten.
• TARGET_PROJECT: der Name oder die ID des Projekts, in das Sie die IP-Adresse verschieben möchten.
• REGION: die Region der IP-Adresse.
• NEW_NAME: ein neuer Name für die IP-Adressressource im neuen Projekt.
• NEW_DESCRIPTION: ein neuer Name für die IP-Adressressource im neuen Projekt. Wenn nichts angegeben ist, wird die vorhandene Beschreibung, falls vorhanden, für die Ressource verwendet.

Weitere Informationen finden Sie in der Referenzdokumentation zu gcloud compute addresses move.

API

Die Details der Anfrage hängen davon ab, ob Sie eine regionale oder globale IP-Adresse verschieben und ob Sie den Adressnamen und die Beschreibung beibehalten oder ersetzen. In den folgenden Beispielen werden einige dieser Kombinationen beschrieben.

• Regionale externe IPv4-Adresse in ein anderes Projekt verschieben:

  POST https://www.googleapis.com/compute/alpha/projects/SOURCE_PROJECT/regions/REGION/addresses/ADDRESS_NAME/move
  {
    "destination_address": "projects/TARGET_PROJECT/global/addresses/ADDRESS_NAME",
  }
  

• Regionale externe IPv4-Adresse in ein anderes Projekt verschieben und ihr einen neuen Namen und eine neue Beschreibung im neuen Projekt zuweisen:

  POST https://www.googleapis.com/compute/alpha/projects/SOURCE_PROJECT/regions/REGION/addresses/ADDRESS_NAME/move
  {
    "destination_address": "projects/TARGET_PROJECT/global/addresses/NEW_NAME",
    "description": "NEW_DESCRIPTION",
  }
  

• Globale externe IPv4-Adresse in ein anderes Projekt verschieben:

  POST https://www.googleapis.com/compute/alpha/projects/SOURCE_PROJECT/global/addresses/ADDRESS_NAME/move
  {
    "destination_address": "projects/TARGET_PROJECT/global/addresses/ADDRESS_NAME",
  }
  

Dabei gilt:

• ADDRESS_NAME: der Name der IP-Adressressource, die Sie verschieben möchten.
• SOURCE_PROJECT: der Name oder die ID des Projekts, in das Sie die IP-Adresse verschieben möchten.
• TARGET_PROJECT: der Name oder die ID des Projekts, in das Sie die IP-Adresse verschieben möchten.
• REGION: die Region der IP-Adresse.
• NEW_NAME: ein neuer Name für die IP-Adressressource im neuen Projekt.
• NEW_DESCRIPTION: ein neuer Name für die IP-Adressressource im neuen Projekt. Wenn nichts angegeben ist, wird die vorhandene Beschreibung, falls vorhanden, für die Ressource verwendet.