Effectuer la migration

Si vous disposez des autorisations IAM appropriées et que les règles d'administration requises sont appliquées, vous pouvez utiliser l'API Resource Manager pour migrer une ressource de projet entre des ressources d'organisation.

Remarque :Les instructions suivantes ne concernent que la migration d'un projet d'une ressource d'organisation vers une autre. Si le projet que vous souhaitez migrer n'est pas associé à une ressource d'organisation, consultez la section Migrer des projets sans ressource d'organisation.

gcloud

Pour migrer un projet vers une autre ressource d'organisation, exécutez la commande suivante:

gcloud beta projects move PROJECT_ID \
    --organization ORGANIZATION_ID

Vous pouvez également spécifier un dossier en tant que ressource cible à l'aide de la commande suivante :

gcloud beta projects move PROJECT_ID \
    --folder FOLDER_ID

Remplacez les champs suivants:

• PROJECT_ID est l'ID ou le numéro du projet que vous souhaitez migrer.
• ORGANIZATION_ID est l'ID de la ressource d'organisation vers laquelle vous souhaitez déplacer le projet. Vous ne pouvez spécifier qu'une seule cible : une ressource d'organisation ou un dossier.
• FOLDER_ID est l'ID du dossier vers lequel vous souhaitez déplacer le projet. Vous ne pouvez spécifier qu'une seule cible : un dossier ou une ressource d'organisation.

Remarque :Vous pouvez exécuter cette commande quel que soit le champ d'application de la Google Cloud CLI.

API

Avec l'API Resource Manager v1, vous pouvez migrer un projet entre des ressources Organisation en définissant son champ parent sur l'ID de la ressource de destination.

Pour migrer un projet, procédez comme suit:

• Récupérez l'objet project à l'aide de la méthode projects.get().
• Définissez son champ parent sur l'ID de ressource d'organisation de la ressource d'organisation ou sur l'ID de dossier du dossier vers lequel vous le déplacez.
• Mettez à jour l'objet project à l'aide de la méthode projects.update().

L'extrait de code suivant illustre les étapes ci-dessus :

    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()

Effectuer un rollback d'une migration

Si vous avez migré un projet par erreur, vous pouvez effectuer un rollback de l'opération en effectuant à nouveau la migration, avec l'ancienne source comme nouvelle destination et l'ancienne comme nouvelle source. Vous devez appliquer les autorisations IAM et les règles d'administration nécessaires pour permettre cette migration comme s'il s'agissait d'une toute nouvelle migration.

Pour effectuer un rollback d'une migration dans laquelle un projet a été migré de l'état Aucune organisation vers une ressource Organisation, contactez le service client Google Cloud.