Migration ausführen

Wenn Sie die entsprechenden IAM-Berechtigungen haben und die erforderlichen Organisationsrichtlinien erzwungen werden, können Sie mit der Resource Manager API eine Projektressource zwischen Organisationsressourcen migrieren.

Hinweis: Die folgende Anleitung gilt nur für die Migration eines Projekts von einer Organisationsressource zu einer anderen. Wenn das zu migrierende Projekt keiner Organisationsressource zugeordnet ist, finden Sie weitere Informationen unter Projekte ohne Organisationsressource migrieren.

gcloud

Führen Sie den folgenden Befehl aus, um ein Projekt zu einer anderen Organisationsressource zu migrieren:

gcloud beta projects move PROJECT_ID \
    --organization ORGANIZATION_ID

Mit dem folgenden Befehl können Sie auch einen Ordner als Zielressource angeben:

gcloud beta projects move PROJECT_ID \
    --folder FOLDER_ID

Ersetzen Sie folgende Felder:

• PROJECT_ID ist die ID oder Nummer des Projekts, das Sie verschieben möchten.
• ORGANIZATION_ID ist die ID der Organisationsressource, in die Sie das Projekt verschieben möchten. Sie können nur ein Ziel angeben, entweder eine Organisationsressource oder einen Ordner.
• FOLDER_ID ist die ID des Ordners, in den Sie das Projekt verschieben möchten. Sie können nur ein Ziel angeben, entweder einen Ordner oder eine Organisationsressource.

Hinweis: Sie können diesen Befehl unabhängig vom Bereich der Google Cloud CLI ausführen.

API

Mit der v1 Resource Manager API können Sie ein Projekt zwischen Organisationsressourcen migrieren. Setzen Sie dazu das Feld parent auf die ID der Zielressource.

So migrieren Sie ein Projekt:

• Rufen Sie mit der Methode projects.get() das Objekt project ab.
• Geben Sie im Feld parent die ID der Organisationsressource der Organisationsressource oder die Ordner-ID des Ordners an, in den Sie sie verschieben.
• Aktualisieren Sie das Objekt project mit der Methode projects.update().

Das folgende Code-Snippet zeigt die obigen Schritte:

    project = crm.projects().get(projectId=flags.projectId).execute()
    project['parent'] = {
        'type': 'organization',
        'id': flags.organizationId
    }

    project = crm.projects().update(
    projectId=flags.projectId, body=project).execute()

Migration rückgängig machen

Wenn Sie ein Projekt versehentlich migriert haben, können Sie den Vorgang rückgängig machen. Führen Sie dazu die Migration noch einmal mit der alten Quelle als neuen Ziel und dem alten Ziel als neue Quelle aus. Sie müssen die erforderlichen IAM-Berechtigungen und Organisationsrichtlinien erzwingen, um dies zuzulassen, als wäre es eine völlig neue Migration.

Wenn Sie eine Migration rückgängig machen möchten, bei der ein Projekt von Keine Organisation zu einer Ressource vom Typ Organisation migriert wurde, wenden Sie sich an Google Cloud Customer Care.