Creazione e gestione delle cartelle

Le cartelle sono nodi all'interno Gerarchia delle risorse della piattaforma Cloud. Una cartella può contenere progetti, altre cartelle o una combinazione di entrambi. Le risorse dell'organizzazione possono utilizzare le cartelle per raggruppare i progetti nel nodo delle risorse dell'organizzazione in un nella gerarchia. Ad esempio, la risorsa dell'organizzazione potrebbe contenere più reparti, ognuna con il proprio set di risorse Google Cloud. Le cartelle ti consentono di raggruppare queste risorse in base al reparto. Le cartelle vengono utilizzate per raggruppare le risorse che condividono criteri IAM comuni. Sebbene una cartella possa contengono più cartelle o risorse, una determinata cartella o risorsa può avere per un solo genitore.

Nel diagramma seguente, la risorsa organizzazione, "Azienda", contiene cartelle che rappresentano due reparti, "Dept X" e "Dept Y" e la cartella "Shared Infrastructure" (Infrastruttura condivisa) che potrebbero essere comuni a entrambi i reparti. In "Dept Y" sono presenti organizzati in due team e, all'interno delle cartelle dei team, vengono organizzati ulteriormente prodotti di big data e machine learning. La cartella per "Prodotto 1" contiene inoltre tre progetti, ognuno con le risorse necessarie per il progetto. Ciò offre un elevato grado di flessibilità nell'assegnazione dei criteri IAM e dei criteri dell'organizzazione al livello di granularità corretto.

Puoi utilizzare i criteri IAM a livello di cartella per controllare l'accesso alle risorse contenute nella cartella. Ad esempio, se a un utente viene assegnato il ruolo Amministratore istanza Compute in una cartella, questo utente dispone del ruolo Amministratore istanza Compute per tutti i progetti nella cartella.

Prima di iniziare

La funzionalità cartella è disponibile solo per Google Workspace e Cloud Identity ai clienti che dispongono di una risorsa dell'organizzazione. Per ulteriori informazioni l'acquisizione di una risorsa dell'organizzazione, consulta Creazione e gestione delle organizzazioni.

Se stai cercando un modo per utilizzare al meglio le cartelle, ti consigliamo di:

1. Rivedi Controllo dell'accesso per le cartelle utilizzando IAM. L'argomento descrive come controllare chi ha accesso alle cartelle e alle risorse che contengono.
2. Scopri come impostare le autorizzazioni per le cartelle. Le cartelle supportano una serie di ruoli IAM diversi. Se vuoi impostare in modo generico le autorizzazioni in modo che gli utenti possano vedere la struttura dei loro progetti, concedi all'intero dominio i ruoli Visualizzatore dell'organizzazione e Visualizzatore della cartella a livello di risorsa dell'organizzazione. Per limitare la visibilità ai rami della gerarchia delle cartelle, concedi il ruolo Visualizzatore di cartelle alla cartella o alle cartelle che vuoi che gli utenti vedano.
3. Creazione di cartelle. Mentre pianifichi come organizzare i tuoi dati ti consigliamo di iniziare con una singola cartella come sandbox in cui puoi sperimentare quale gerarchia è più adatta al tuo risorsa dell'organizzazione. Considera le cartelle come confini di isolamento tra le risorse e i punti di collegamento per i criteri di accesso e configurazione. Puoi scegliere di creare cartelle contenenti risorse appartenenti a diversi reparti e assegnare ruoli amministrativi alle cartelle per delegare i privilegi amministrativi. Le cartelle possono essere utilizzate anche per raggruppare le risorse che appartengono a applicazioni o ambienti diversi, come sviluppo, produzione e test. Utilizza cartelle nidificate per creare un modello per questi diversi scenari.

Una situazione comune è creare cartelle che a loro volta contengono altre cartelle o progetti, come mostrato nell'immagine sopra. Questa struttura è nota come gerarchia di cartelle. Quando crei una gerarchia di cartelle, tieni presente quanto segue:

• Puoi nidificare le cartelle fino a 10 (dieci) livelli di profondità.
• Una cartella principale non può contenere più di 300 cartelle. Si riferisce solo alle cartelle secondarie dirette. Queste cartelle secondarie possono, a loro volta, contenere elementi cartelle o progetti.
• I nomi di cartella visualizzati devono essere univoci all'interno dello stesso livello gerarchico.

Configurare le autorizzazioni per gestire le cartelle

Per accedere alle cartelle e gestirle, devi assegnare ruoli IAM specifici per le cartelle a a specifici gruppi di utenti. Per scoprire di più su questi ruoli, vedi Controllo dell'accesso alle cartelle mediante IAM. Ti consigliamo inoltre di consultare le nostre best practice per identificare la configurazione ottimale per le autorizzazioni delle cartelle.

Per gestire le cartelle per l'intera risorsa dell'organizzazione, è necessario il Amministratore. Questo ruolo concede all'utente l'autorizzazione per creare, modificare, eliminare, spostare e modificare le autorizzazioni IAM per le cartelle, nonché l'autorizzazione per spostare i progetti tra le cartelle.

Inizialmente, solo l'amministratore dell'organizzazione può assegnare il ruolo Amministratore cartelle per la risorsa dell'organizzazione. Gli account successivi a cui viene assegnato questo ruolo possono concederlo ad altri account.

Per configurare le autorizzazioni delle cartelle:

console

1. Nella console Google Cloud, apri la pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Se il riquadro informazioni non è aperto, fai clic su Mostra riquadro informazioni.
3. Nella tabella Risorse, espandi l'organizzazione che contiene .
4. Dall'elenco delle risorse in Organizzazione, seleziona la cartella che vuoi gestire.
5. Nel riquadro delle informazioni, fai clic su Aggiungi entità.
6. Nel campo Aggiungi entità, inserisci l'indirizzo email che vuoi a cui concedere le autorizzazioni.
7. Nel menu Seleziona un ruolo, seleziona la categoria Gestore risorse e poi il ruolo che vuoi concedere, ad esempio Amministratore cartelle.
8. Fai clic su Salva per concedere il nuovo ruolo.

gcloud

Per concedere il ruolo Amministratore cartelle a un'entità utilizzando Google Cloud CLI, esegui questo comando:

    gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
    --member=user:USER_ID \
    --role=roles/resourcemanager.folderAdmin

API

Il codice JSON della richiesta:

request_json= '{ policy: { version: "1", bindings: [ { role: "roles/folderAdmin",
members: [ "user:[e-mail]", ] }, { role: "roles/folderCreator",
members: [   "user:[e-mail]", ] } , { role: "roles/folderMover",
members: [ "user:[e-mail]", ] } , ] } }'

La richiesta curl:

curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
-d "$request_json" \
https://cloudresourcemanager.googleapis.com/v3/ORGANIZATION_NAME:setIamPolicy

Sostituisci ORGANIZATION_NAME con il nome dell'organizzazione di cui viene applicato il criterio IAM impostato, ad esempio organizations/123.

Creazione di cartelle

Per creare cartelle, devi disporre del ruolo Amministratore cartelle o Creatore cartelle a livello principale. Ad esempio, per creare cartelle a livello di organizzazione, devi disporre di uno di questi ruoli a livello di organizzazione.

Durante la creazione di una cartella, devi assegnarle un nome. I nomi delle cartelle devono soddisfare i seguenti requisiti:

• Il nome può contenere lettere, cifre, spazi, trattini e trattini bassi.
• Il nome visualizzato della cartella deve iniziare e terminare con una lettera o una cifra.
• Il nome deve essere compreso tra 3 e 30 caratteri.
• Il nome deve essere diverso da tutte le altre cartelle che condividono l'elemento principale.

Per creare una cartella:

Console

Le cartelle possono essere create nell'interfaccia utente utilizzando la sezione "Gestisci progetti e cartelle".

1. Vai alla pagina Gestisci risorse nella console Google Cloud:

   Apri la pagina Gestisci risorse

2. Assicurati che il nome della risorsa dell'organizzazione sia selezionato nell'elenco a discesa dell'organizzazione nella parte superiore della pagina.

3. Fai clic su Crea cartella e seleziona una delle seguenti opzioni:

   • Cartella Standard: un file standard risorsa cartella.
   • Cartella conforme: una cartella Assured Workloads, che fornisce controlli aggiuntivi a livello di normative, regionali o di sovranità per le risorse Google Cloud. Se selezioni questa opzione, verrà visualizzata la pagina Assured Workloads per creare una cartella.

4. Nella casella Nome cartella, inserisci il nome della nuova cartella.

5. In Destinazione, fai clic su Sfoglia e seleziona la risorsa o la cartella dell'organizzazione in cui vuoi creare la nuova cartella.

   1. Fai clic su Crea.

gcloud

Le cartelle possono essere create in modo programmatico utilizzando Google Cloud CLI.

Per creare una cartella nella risorsa organizzazione utilizzando gcloud a strumento a riga di comando, esegui questo comando.

gcloud resource-manager folders create \
   --display-name=[DISPLAY_NAME] \
   --organization=[ORGANIZATION_ID]

Per creare una cartella la cui cartella principale è un'altra cartella:

gcloud resource-manager folders create \
   --display-name=[DISPLAY_NAME] \
   --folder=[FOLDER_ID]

Dove:

• [DISPLAY_NAME] è il nome visualizzato della cartella. Nessuna delle due cartelle con lo stesso elemento principale può condividere un nome visualizzato. Il nome visualizzato deve iniziare e terminare con una lettera o una cifra, può contenere lettere, cifre, spazi e trattini e trattini bassi e non possono superare i 30 caratteri.
• [ORGANIZATION_ID]è l'ID della risorsa dell'organizzazione padre se la risorsa padre è una risorsa dell'organizzazione.
• [FOLDER_ID] è l'ID della cartella principale, se si tratta di una cartella.

API

Le cartelle possono essere vengono creati con una richiesta API.

Il codice JSON della richiesta:

request_json= '{
  display_name: DISPLAY_NAME,
  parent: ORGANIZATION_NAME
}'

La richiesta curl Create Folder:

curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
-d "$request_json" \
https://cloudresourcemanager.googleapis.com/v3/folders

Dove:

• [DISPLAY_NAME] è il nome visualizzato della nuova cartella, ad esempio "La mia cartella Awesome."
• [ORGANIZATION_NAME] è il nome della risorsa dell'organizzazione in base alla quale stai creando la cartella, ad esempio organizations/123.

La risposta Crea cartella:

{
  "name": "operations/fc.123456789",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "[DISPLAY_NAME]",
    "operationType": "CREATE"
  }
}

La richiesta Get Operation curl:

curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fc.123456789

La risposta all'operazione Get:

{
  "name": "operations/fc.123456789",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "[DISPLAY_NAME]",
    "operationType": "CREATE"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.Folder",
    "name": "folders/12345",
    "parent": "organizations/123",
    "displayName": "[DISPLAY_NAME]",
    "lifecycleState": "ACTIVE",
    "createTime": "2017-07-19T23:29:26.018Z",
    "updateTime": "2017-07-19T23:29:26.046Z"
  }
}

Aggiungere tag durante la creazione delle cartelle

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

I tag consentono di creare annotazioni per le risorse. Puoi aggiungere i tag al momento della creazione delle cartelle. Per farlo, devi concedere il ruolo Utente tag. Per ulteriori informazioni sulle autorizzazioni contenute in questo ruolo, consulta Gestire i tag nelle risorse. Puoi aggiungere lo spazio dei nomi per le coppie chiave-valore dei tag solo in uno dei seguenti modi:

gcloud

Per aggiungere tag durante la creazione della cartella, esegui il seguente comando:

  gcloud resource-manager folders create \
  --display-name=DISPLAY_NAME \
  --organization=ORGANIZATION_ID
  --tags=KEY_VALUE_PAIRS

Sostituisci quanto segue:

• DISPLAY_NAME è il nome visualizzato della cartella.
• ORGANIZATION_ID è l'identificatore univoco della risorsa dell'organizzazione principale.
• KEY_VALUE_PAIRS è un elenco di coppie chiave-valore separate da virgole che puoi assegnare alla risorsa. Un esempio di coppie chiave-valore separate da virgole è 123/environment=production, 456/create=testresource.

API

Il seguente snippet è una richiesta JSON che crea una cartella e aggiunge i tag.

  POST https://cloudresourcemanager.googleapis.com/v3/projects/
  Authorization: *************
  Content-Type: application/json

  {
    "display_name": "our-folder-456",
    "parent": "organizations/123",
    "tags": {
      "key": "123/environment"
      "value": "production"
    },
"tags": {
      "key": "123/costCenter"
      "value": "marketing"
    }
  }

Configurazione dell'accesso alle cartelle

Per configurare l'accesso alle cartelle, devi avere l'amministratore IAM della cartella o Amministratore cartelle a livello principale.

Console

1. Nella console Google Cloud, apri la pagina Gestisci risorse.

   Apri la pagina Gestisci risorse

2. Fai clic sull'elenco a discesa Organizzazione in alto a sinistra e poi seleziona la risorsa dell'organizzazione.

3. Seleziona la casella di controllo accanto al progetto per cui vuoi modificare le autorizzazioni.

   1. Sul lato destro del riquadro Informazioni, in Autorizzazioni, inserisci gli indirizzi email dei membri che vuoi aggiungere.

   2. Nell'elenco a discesa Seleziona un ruolo, seleziona il ruolo da concedere ai membri.

   3. Fai clic su Aggiungi. Viene visualizzata una notifica per confermare l'aggiunta o l'aggiornamento del nuovo ruolo dei membri.

gcloud

Puoi configurare l'accesso alle cartelle in modo programmatico utilizzando Google Cloud CLI o l'API.

gcloud resource-manager folders \
  add-iam-policy-binding [FOLDER_ID] \
  --member=user:[e-mail] \
  --role=roles/resourcemanager.folderEditor

gcloud resource-manager folders \
  add-iam-policy-binding [FOLDER_ID] \
  --member=user:[e-mail] \
  --role=roles/resourcemanager.folderViewer

In alternativa:

gcloud resource-manager folders \
  set-iam-policy [FOLDER_ID] [POLICY_FILE]

Dove:

• [FOLDER_ID] è l'ID della nuova cartella.
• [POLICY_FILE] è il percorso di un file di criteri per la cartella.

API

Il metodo setIamPolicy imposta il criterio di controllo accessi in una cartella, sostituendo qualsiasi criterio esistente. Il campo resource deve essere il nome della risorsa della cartella, ad esempio folders/1234.

 request_json= '{
   policy: {
     version: "1",
     bindings: [
       {
         role: "roles/resourcemanager.folderEditor",
         members: [
           "user:[e-mail]",
           "user:[e-mail]",
         ]
       }
     ]
   }
 }'

La richiesta curl:

   curl -X POST -H "Content-Type: application/json" \
   -H "Authorization: Bearer ${bearer_token}" \
   -d "$request_json" \
   https://cloudresourcemanager.googleapis.com/v3/[FOLDER_NAME]:setIamPolicy

Dove:

• [FOLDER_NAME] è il nome della cartella di cui viene impostato il criterio IAM, ad esempio cartelle/123.

Creazione di un progetto in una cartella

Per creare un progetto in una cartella, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator) nella cartella. Questo ruolo può essere ereditato da una cartella principale.

console

1. Nella console Google Cloud, apri la pagina Gestisci risorse.

   Apri la console Google Cloud

2. Vai alla pagina Gestisci risorse.
3. Seleziona la risorsa dell'organizzazione dall'elenco a discesa Organizzazione in alto sinistra della pagina.
4. Fai clic su Crea progetto.
5. Inserisci un Nome progetto.

6. Nella casella Destinazione, fai clic su Sfoglia per selezionare la cartella sotto. in cui vuoi creare il progetto.

7. Fai clic su Crea.

gcloud

  gcloud projects create PROJECT_ID --folder FOLDER_ID

Sostituisci quanto segue:

• PROJECT_ID è l'ID dell'ID progetto da creare.
• FOLDER_ID è l'ID della cartella in cui deve essere creato il progetto.

API

Il codice JSON della richiesta:

   request_json= '{
      name: DISPLAY_NAME, projectId: PROJECT_ID, parent: {id: PARENT_ID, type: PARENT_TYPE}
   }'

La richiesta curl:

   curl -X POST -H "Content-Type: application/json" \
   -H "Authorization: Bearer ${bearer_token}" \
   -d "$request_json" \
   https://cloudresourcemanager.googleapis.com/v3/projects

Sostituisci quanto segue:

• PROJECT_ID è l'identificatore univoco del progetto in fase di creazione. Ad esempio, my-awesome-proj-123.
• DISPLAY_NAME è il nome visualizzato del progetto che viene creato.
• PARENT_ID è l'identificatore univoco dell'elemento principale in cui viene creato. Ad esempio, 123.
• PARENT_TYPE è il tipo di elemento principale, ad esempio folder o organization.

Non includere informazioni sensibili nel nome della cartella o di altre risorse. Qualsiasi riferimento alla cartella o alle risorse correlate espone il nome della cartella e della risorsa.

Spostamento di un progetto in una cartella

Devi valutare attentamente le implicazioni delle norme prima di spostare un progetto in una cartella o rimuoverlo da una cartella. I criteri di Identity and Access Management che definisci A livello di progetto verrà spostato con il progetto, ma i criteri ereditati da un la risorsa padre non verrà spostata.

Nota: le istruzioni riportate di seguito riguardano solo lo spostamento di un progetto all'interno di una risorsa dell'organizzazione. Per informazioni sulla migrazione di un progetto tra risorse dell'organizzazione, consulta Migrazione dei progetti.

Quando sposti un progetto, vengono spostati con esso anche i criteri di Identity and Access Management o dell'organizzazione collegati direttamente. Tuttavia, un progetto nella tua risorsa la gerarchia è influenzata anche dai criteri che eredita dall'elemento padre Google Cloud. 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 non ereditino l'autorizzazione anche nella destinazione.

Ad esempio, supponiamo che un account di servizio abbia Creatore oggetti Storage associato a un utente nella cartella A. L'account di servizio dispone delle autorizzazioni per il caricamento 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 del progetto perde la possibilità di caricare dati, causando un'interruzione del servizio.

Queste stesse considerazioni valgono se i criteri dell'organizzazione sono definiti a livello alle cartelle di origine e di destinazione. Come i criteri IAM, i criteri dell'organizzazione vengono ereditati. Di conseguenza, devi assicurarti che la tua organizzazione sono coerenti tra le cartelle di origine e di destinazione.

Per scoprire di più sui criteri dell'organizzazione, consulta Introduzione al servizio dei criteri dell'organizzazione.

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

Questi ruoli ti concedono le seguenti autorizzazioni obbligatorie:

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

Puoi anche ottenere queste autorizzazioni con 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 della pagina.

3. Fai clic sulla riga del progetto per selezionarlo dall'elenco Google Cloud. Tieni presente che non devi fare clic sul nome del progetto, in quanto si aprirà la pagina IAM del progetto.

4. Fai clic sul menu delle 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 l'attività.

• 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 la versione 3 Metodo 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 che ti interessa da aggiornare. Ad esempio, projects/415104041262

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

Se l'esito è positivo, la richiesta restituirà Operazione, ovvero può essere utilizzato per monitorare lo spostamento del progetto.

Spostamento di una cartella in un'altra cartella

Per spostare una cartella in un'altra, devi disporre dell'autorizzazione resourcemanager.folders.move sia per le cartelle di origine sia per quelle di destinazione.

console

La procedura per spostare le cartelle in altre cartelle nella console è simile allo spostamento dei progetti.

1. Nella console Google Cloud, apri la pagina Gestisci risorse.

   Apri la console Google Cloud

2. Seleziona la risorsa dell'organizzazione dal menu a discesa Organizzazione in alto a sinistra della pagina.
3. Fai clic sulla riga della cartella per selezionarla dall'elenco di di progetti e cartelle.
4. Fai clic sul menu opzioni (i tre puntini verticali) nella riga e poi su Sposta.
5. Fai clic su Sfoglia per selezionare la cartella in cui spostare il .
6. Fai clic su Sposta.

gcloud

Per spostare una cartella nella risorsa Organizzazione, esegui il seguente comando nella CLI Google Cloud:

gcloud resource-manager folders move [FOLDER_ID] \
  --organization=[PARENT_ID]

Per spostare una cartella in un'altra cartella:

gcloud resource-manager folders move [FOLDER_ID] \
  --folder=[PARENT_ID]

Sostituisci quanto segue:

• [FOLDER_ID] è l'ID della cartella da spostare.
• [PARENT_ID] è l'ID risorsa organizzazione o l'ID cartella dell'elemento padre di una risorsa o di una cartella dell'organizzazione.

API

Il codice JSON della richiesta:

request_json= '{
   destinationParent: "folders/[DESTINATION_FOLDER_ID]"
}'

La richiesta curl di Sposta cartella:

curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token} \
-d "$request_json" \
https://cloudresourcemanager.googleapis.com/v3/folders/[DISPLAY_NAME]:move

Sostituisci quanto segue:

• [DESTINATION_FOLDER_ID] è l'ID della cartella in cui ti trovi Spostare un'altra cartella, ad esempio 98765.
• [DISPLAY_NAME] è il nome visualizzato della cartella che viene spostata, ad esempio "La mia cartella Awesome."

La risposta per lo spostamento della cartella:

{
  "name": "operations/fm.1234567890",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "[DISPLAY_NAME]",
    "operationType": "MOVE"
  }
}

La richiesta Get Operation curl:

curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fm.1234567890

La risposta all'operazione Get:

{
  "name": "operations/fm.1234567890",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "[DISPLAY_NAME]",
    "operationType": "MOVE"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.Folder",
    "name": "folders/12345",
    "parent": "folders/98765",
    "displayName": "[DISPLAY_NAME]",
    "lifecycleState": "ACTIVE",
    "createTime": "2017-07-19T23:29:26.018Z",
    "updateTime": "2017-07-20T00:54:44.295Z"
  }
}

Visualizzazione o elencazione di cartelle e progetti

Per visualizzare o elencare le cartelle, devi disporre dei ruoli Visualizzatore organizzazione e Visualizzatore cartelle.

Per visualizzare o elencare cartelle e progetti:

console

1. Nella console Google Cloud, apri la pagina Gestisci risorse.

   Apri la pagina Gestisci risorse

2. Dal selettore di progetti nella parte superiore della pagina, seleziona la tua organizzazione. risorsa. Le cartelle devono essere create prima di essere visualizzate in questo elenco.

   Nota: nel selettore di progetti possono essere visualizzate fino a 4000 risorse. Se non vedi una risorsa che dovrebbe essere visualizzata, vai alla scheda Gestisci risorse pagina e filtra l'elenco utilizzando il nome della risorsa.

3. Seleziona una riga nell'albero per eseguire operazioni specifiche per cartelle o progetti.

   Nota: il menu opzioni (i puntini di sospensione verticali) a destra mostra le opzioni per le operazioni supportate.

4. Inserisci il nome/l'ID del progetto o della cartella nella ricerca per filtrare l'elenco.

gcloud

Per visualizzare i dettagli di una cartella, utilizza resource-manager folders describe .

gcloud resource-manager folders describe FOLDER_ID

Sostituisci FOLDER_ID con l'ID della cartella che vuoi utilizzare da visualizzare.

Per elencare le cartelle secondarie di una risorsa dell'organizzazione, utilizza il comando resource-manager folders list.

gcloud resource-manager folders list \
  --organization ORGANIZATION_ID

Sostituisci ORGANIZATION_ID con l'ID del organizzazione per la quale vuoi visualizzare un elenco di cartelle secondarie.

Per elencare le cartelle secondarie di una risorsa cartella, utilizza Comando resource-manager folders list.

gcloud resource-manager folders list \
  --folder FOLDER_ID

Sostituisci FOLDER_ID con l'ID della risorsa della cartella per cui vuoi visualizzare un elenco di cartelle secondarie.

Per elencare i progetti in una risorsa o in una cartella di un'organizzazione, utilizza il comando projects list con l'argomento filter.

gcloud projects list \
  --filter=" parent.id: 'RESOURCE_ID' "

Sostituisci RESOURCE_ID con l'ID del organizzazione o cartella di cui vuoi visualizzare un elenco di risorse in modo programmatico a gestire i progetti.

API

La richiesta curl per recuperare le cartelle:

curl -X GET -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${bearer_token}" \
  https://cloudresourcemanager.googleapis.com/v3/[FOLDER_NAME]

Sostituisci FOLDER_NAME con il nome della cartella, ad esempio folders/123.

La richiesta curl per elencare le cartelle:

curl -X GET -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${bearer_token}" \
  https://cloudresourcemanager.googleapis.com/v3/folders?parent=[PARENT_NAME]

Sostituisci PARENT_NAME con il nome della risorsa padre in cui stai creando la cartella, come organizations/123 o folders/123.

Utilizzo di Google Cloud CLI

I comandi per interagire con l'API Folders con lo strumento a riga di comando gcloud sono disponibili nel gruppo di comandi gcloud resource-manager folders.

Crea

Per creare una nuova cartella, utilizza gcloud resource-manager folders create con i flag che impostano il nome della cartella e l'ID della risorsa o della cartella dell'organizzazione in cui vuoi che venga creata.

gcloud resource-manager folders create \
  --display-name="Super Fantastic Folder" \
  --organization=2518

Created Folder 245321.

Visualizza

Per visualizzare una cartella, usa gcloud resource-manager folders describe con ID della cartella che vuoi visualizzare.

gcloud resource-manager folders describe 245321
name: folders/245321
parent: organizations/2518
display_name: Super Fantastic Folder
lifecycle_state: ACTIVE
create_time: <timestamp info …>
update_time: <timestamp info …>

Elenco

Per elencare le cartelle sotto una cartella, usa gcloud resource-manager folders list, passando l'ID cartella nel flag --folder. Puoi anche elencare le cartelle di primo livello in una risorsa dell'organizzazione, utilizzando il flag --organization.

gcloud resource-manager folders list --folder 245321
<table output showing the folders underneath the folder with the specified ID>

gcloud resource-manager folders list --organization 2518
<table output showing folders in this Organization but not in any folder>

Per includere nell'elenco le cartelle per le quali è richiesta l'eliminazione, aggiungi il flag --show-deleted

gcloud beta resource-manager folders list --folder 245321 --show-deleted
<table output showing all the folders including the delete requested ones underneath the folder with the specified ID>

Nota: il flag --show-deleted è attualmente supportato solo nelle versioni alpha e beta del comando.

Puoi elencare i progetti utilizzando gcloud projects list passando l'ID risorsa dell'organizzazione o della cartella padre nel flag --filter.

gcloud projects list --filter=" parent.id: '245321' "
<table output showing the projects underneath the resource with the specified ID>

Per ulteriori informazioni su come le autorizzazioni e i filtri interagiscono con l'elenco consulta la sezione Elenco di tutte le risorse nella gerarchia.

Nota: l'elenco di progetti e cartelle restituirà solo i discendenti diretti della risorsa di destinazione e non mostrerà i discendenti dei figli.

Cerca

Per cercare le cartelle corrispondenti alla query specificata, utilizza gcloud alpha resource-manager folders search, passando la condizione nel flag --query. L'ambito della ricerca è costituito da tutte le cartelle per le quali l'utente dispone dell'autorizzazione di visualizzazione.

gcloud alpha resource-manager folders search --query="name:vij*"
<table output showing the folders with names starting from vij eg. vijeta, vijay-folder>

gcloud alpha resource-manager folders search --query="state:DELETE_REQUESTED"
<table output showing folders for which delete has been requested>

Tutte le cartelle per le quali l'utente dispone dell'autorizzazione di visualizzazione possono essere mostrate utilizzando il comando gcloud folders search.

gcloud folders search
<table output showing all viewable folders>

Nota: il comando di ricerca è in versione alpha e può essere modificato senza preavviso.

Aggiorna

Le cartelle possono essere aggiornate con il comando gcloud resource-manager folders update. Al momento, è possibile aggiornare solo il campo display_name di una cartella.

gcloud resource-manager folders update \
  --display-name="Mega Incredible Folder" 245321
name: folders/245321
parent: organizations/2518
display_name: Mega Incredible Folder
lifecycle_state: ACTIVE
create_time: <timestamp info …>
update_time: <recent timestamp info …>

Elimina

Le cartelle possono essere eliminate e annullate dall'eliminazione dalla riga di comando. Un utente deve possedere il ruolo Amministratore cartelle o Editor cartelle per avere l'autorizzazione eliminare una cartella. Puoi eliminare una cartella solo se è vuota.

gcloud resource-manager folders delete 245321
name: folders/245321
parent: organizations/2518
display_name: Mega Incredible Folder
lifecycle_state: DELETE_REQUESTED
create_time: <timestamp info …>
update_time: <recent timestamp info …>

gcloud resource-manager folders undelete 245321
name: folders/245321
parent: organizations/2518
display_name: Mega Incredible Folder
lifecycle_state: ACTIVE
create_time: <timestamp info …>
update_time: <recent timestamp info …>

Spostamento progetto

I progetti possono essere creati in cartelle e spostati nelle cartelle utilizzando Comandi gcloud projects create e gcloud projects move. Le cartelle possono essere spostate anche utilizzando gcloud resource-manager folders move.

gcloud projects create --folder=245321 fancy-folder-project
project_id: fancy-folder-project
project_number: 905283
parent:
  type: "folder"
  id: 245321
other fields …

gcloud projects move --folder=245321 soon-to-be-fancy-project
project_id: soon-to-be-fancy-project
project_number: 428714
parent:
  type: "folder"
  id: 245321
other fields …

Operazioni a lunga esecuzione

Alcune operazioni sulle cartelle, ad esempio la creazione delle cartelle, possono richiedere molto tempo. Per semplificare il multitasking, alcuni comandi della cartella ti consentono di eseguirli in modo asincrono. Questi comandi accettano un flag --async per abilitare la modalità il comportamento degli utenti, con la conseguente restituzione immediata di un'operazione a lunga esecuzione anziché in attesa del completamento dell'operazione. Puoi eseguire il polling di questa operazione autonomamente con il comando gcloud beta resource-manager operations describe. Al momento, solo i comandi folders create e folders move consentono l'utilizzo asincrono.

gcloud resource-manager folders create \
  --display-name="Awe-Inspiring Async Folder" \
  --organization=2518 \
  --async

name: operations/fc.8572
metadata:
  operation_type: CREATE
  display_name: Awe-Inspiring Async Folder
  destination_parent: organizations/2518
done: false

[wait for some time …]

gcloud beta resource-manager operations describe fc.8572
name: operations/fc.8572
metadata:
  operation_type: CREATE
  display_name: Awe-Inspiring Async Folder
  destination_parent: organizations/2518
done: true
response:
  name: folders/6428
  parent: organizations/2518
  display_name: Awe-Inspiring Async Folder
  lifecycle_state: ACTIVE
  create_time: <recent timestamp info …>
  update_time: <recent timestamp info …>