Spostamento di un progetto

Questa guida spiega come spostare un progetto all'interno della risorsa dell'organizzazione.

Il progetto è l'entità di organizzazione di base in una risorsa dell'organizzazione Google Cloud. I progetti vengono creati nelle risorse dell'organizzazione e possono essere inseriti nelle cartelle o nella risorsa dell'organizzazione stessa, formando la gerarchia delle risorse. Puoi spostare le risorse del progetto all'interno della gerarchia delle risorse, ma prima di eseguire lo spostamento devi tenere conto delle implicazioni dei criteri.

Quando sposti un progetto, tutti i criteri di Identity and Access Management o i criteri dell'organizzazione direttamente collegati verranno spostati insieme al progetto. Tuttavia, un progetto nella gerarchia delle risorse è interessato anche dai criteri che eredita dalle risorse padre. Se un progetto eredita un ruolo IAM che fornisce agli utenti l'autorizzazione per utilizzare un determinato servizio, gli utenti non avranno accesso a quel servizio nella destinazione, a meno che quest'ultimo non erediti anche l'autorizzazione a quella di destinazione.

Ad esempio, supponiamo che un account di servizio abbia il ruolo Creatore oggetti Storage associato a un utente nella Cartella A. L'account di servizio dispone delle autorizzazioni per caricare dati in Cloud Storage in qualsiasi progetto nella Cartella A. Se hai spostato uno di questi progetti nella Cartella B, che non ha le stesse autorizzazioni ereditate, l'account di servizio per il progetto perde la possibilità di caricare dati, causando un'interruzione del servizio.

Queste stesse considerazioni si applicano se i criteri dell'organizzazione sono definiti nelle cartelle di origine e di destinazione. Come i criteri IAM, quelli dell'organizzazione vengono ereditati. Di conseguenza, devi assicurarti che i criteri dell'organizzazione siano coerenti tra le cartelle di origine e di destinazione.

Per saperne di più sui criteri dell'organizzazione, vedi Introduzione al servizio Criteri dell'organizzazione.

Per spostare un progetto, devi disporre del ruolo IAM Autore spostamento progetto (roles/resourcemanager.projectMover) sia nella cartella di origine sia in quella di destinazione. Se la risorsa non si trova in una cartella, hai bisogno di questo ruolo nella risorsa organizzazione.

Questi ruoli offrono le seguenti autorizzazioni richieste:

  • resourcemanager.projects.update nel progetto
  • Se la risorsa si trova in una cartella: resourcemanager.projects.move nella cartella di origine e nella destinazione
  • Se la risorsa non si trova in una cartella: resourcemanager.projects.move nella risorsa dell'organizzazione

Puoi ottenere queste autorizzazioni anche con i ruoli personalizzati o altri ruoli predefiniti.

Console

Per spostare un progetto:

  1. Nella console Google Cloud, vai alla pagina Gestisci risorse.

    Vai a Gestisci risorse

  2. Seleziona la tua organizzazione dal menu a discesa Organizzazione in alto a sinistra nella pagina.

  3. Fai clic sulla riga del progetto per selezionare il progetto dall'elenco delle risorse. Tieni presente che non devi fare clic sul nome del progetto per accedere alla relativa pagina IAM.

  4. Fai clic sul menu opzioni (i puntini di sospensione verticali) nella riga e fai clic su Sposta.

  5. Fai clic su Sfoglia per selezionare la cartella in cui vuoi spostare il progetto.

  6. Fai clic su Sposta.

gcloud

Per spostare un progetto, esegui il comando gcloud beta projects move:

gcloud beta projects move PROJECT_ID \
--DESTINATION_TYPE DESTINATION_ID

Dove:

  • PROJECT_ID è l'ID o il numero del progetto che vuoi spostare.

  • DESTINATION_TYPE è organization o folder.

  • DESTINATION_ID è l'ID della risorsa o della cartella dell'organizzazione in cui vuoi spostare il progetto. Puoi specificare un solo target.

API

Puoi utilizzare il metodo v3 projects.move per spostare un progetto.

Richiesta:

POST https://cloudresourcemanager.googleapis.com/v3/{name=PROJECT_NAME}:move
{
  "destinationParent": DESTINATION_PARENT
}

Dove:

  • PROJECT_NAME è il nome del progetto da aggiornare. Ad esempio, projects/415104041262

  • DESTINATION_PARENT è la nuova risorsa o cartella dell'organizzazione padre in cui vuoi spostare il progetto. Ad esempio: organizations/12345678901

Se l'esito è positivo, la richiesta restituirà un'operazione che può essere utilizzata per monitorare lo spostamento del progetto.