Externe IPv4-Adresse in ein anderes Projekt verschieben

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 in den entsprechenden Kontingenten f�r die IP-Adressen 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 f�r alle IP-Adressen die Kontingente f�r Anfragen zur Adressverschiebung.
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 (statisch), 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.
- Die IP-Adresse wurde vom Cloud-Support nicht als Teil eines zusammenh�ngenden IP-Adressbereichs reserviert. Weitere Informationen finden Sie unter Externe IPv4-Adresse verschieben schl�gt fehl.

Beschr�nkungen

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.
Sie k�nnen die Region einer regionalen IP-Adresse nicht �ndern.
Globale IP-Adressen k�nnen nicht in regionale oder regionale IP-Adressen in globale umgewandelt werden.

Kontingente

Die Anzahl der Adressen, die Sie pro Minute verschieben k�nnen, ist begrenzt. Weitere Informationen erhalten Sie im Abschnitt zu projektbasierten Kontingenten in der VPC-Dokumentation.

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 IP-Adressressource standardm��ig derselbe Name und dieselbe Beschreibung zugewiesen. Sie k�nnen jedoch einen neuen Namen oder eine neue Beschreibung zuweisen. Nachdem die externe IPv4-Adresse in ein neues Projekt verschoben wurde, k�nnen Sie sie zul�ssigen Ressourcen in diesem Projekt zuweisen.

Console

Rufen Sie in der Google Cloud Console IP-Adressen auf.

"IP-Adressen" aufrufen
W�hlen Sie im Men� Weitere Aktionen () der IP-Adresse, die Sie verschieben m�chten, die Option In ein anderes Projekt verschieben aus.
Klicken Sie auf Projekt ausw�hlen und w�hlen Sie das Projekt aus, in das Sie die IP-Adresse verschieben m�chten.
Optional: Geben Sie f�r die IP-Adresse einen neuen Namen ein.
Optional: Geben Sie eine neue Beschreibung f�r die IP-Adresse ein.
Klicken Sie auf Verschieben.

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 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 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 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/v1/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/v1/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/v1/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.

Fehlerbehebung

Das Verschieben einer externen IPv4-Adresse schl�gt fehl

Wenn Sie versuchen, eine externe IPv4-Adresse zu verschieben, wird m�glicherweise die folgende Fehlermeldung angezeigt:

Invalid resource usage: 'Cannot move address that belongs to a reserved address range. Address range must be disassembled first.'

Wenn diese Meldung angezeigt wird, bedeutet dies, dass die IP-Adresse vom Cloud-Support als Teil eines zusammenh�ngenden IP-Adressbereichs reserviert wurde. Wenn Sie eine IP-Adresse dieses Typs verschieben m�chten, wenden Sie sich an den Cloud-Support. Der Cloud-Support kann den gesamten IP-Adressbereich in ein anderes Projekt verschieben. Das Verschieben nur eines Teils des Bereichs wird nicht unterst�tzt.

So pr�fen Sie, ob eine IP-Adresse Teil eines Bereichs ist, der vom Cloud-Support reserviert wurde:

Listen Sie statische externe IP-Adressen auf und suchen Sie die IP-Adresse, die Sie pr�fen m�chten.
Pr�fen Sie den Name der IP-Adresse. Wenn die IP-Adresse vom Cloud-Support reserviert wurde, besteht ihr Name aus einem String, gefolgt von den vier Byte der IP-Adresse, die durch Bindestriche getrennt sind. Wenn die IP-Adresse beispielsweise 198.51.100.2 lautet und vom Cloud-Support reserviert wurde, hat der Name das folgende Format: STRING-198-51-100-2. Andere IP-Adressen, die als Teil desselben Bereichs reserviert waren, haben denselben String, gefolgt von ihren IP-Adressen.