Visualizzare, aggiornare ed eliminare cartelle

Puoi visualizzare i dettagli delle cartelle, aggiornare i nomi visualizzati, spostare le cartelle ed eliminare quelle non necessarie utilizzando la console Google Cloud , Google Cloud CLI o l'API Cloud Resource Manager. La gestione delle cartelle ti consente di organizzare le risorse e mantenere la gerarchia delle risorse Google Cloud man mano che i progetti e i team si evolvono.

Elencare le cartelle e visualizzarne i dettagli

Per elencare le cartelle o visualizzare i metadati di una cartella specifica, ad esempio il nome visualizzato, l'ID padre e lo stato del ciclo di vita, devi disporre del ruolo Visualizzatore cartelle (roles/resourcemanager.folderViewer) o Visualizzatore organizzazione (roles/resourcemanager.organizationViewer).

Console

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

    Apri la pagina Gestisci risorse

  2. L'elenco delle risorse mostra la gerarchia sotto forma di tabella. Seleziona la risorsa della tua organizzazione.

  3. Fai clic sulla freccia accanto al nome dell'organizzazione per espandere la visualizzazione ad albero e visualizzare le cartelle secondarie.

  4. Per eseguire azioni, ad esempio spostare, eliminare o visualizzare le impostazioni, fai clic su Azioni alla fine della riga per la risorsa specifica.

  5. Utilizza la barra Filtro nella parte superiore dell'elenco delle risorse per cercare le risorse per nome, ID o etichetta.

Per informazioni su come la pagina Gestisci risorse calcola il timestamp Ultimo accesso per cartelle e progetti, consulta Informazioni sul timestamp Ultimo accesso.

Utilizzo del selettore di progetti

Il selettore di progetti si trova nella barra di navigazione e non fa parte dell'interfaccia della pagina principale di Resource Manager. Utilizzalo per cambiare il contesto globale attivo in un progetto o una cartella specifici.

  1. Fai clic sul selettore di progetti. Nella finestra di dialogo visualizzata, seleziona la tua organizzazione dal menu a discesa per filtrare i risultati.

  2. Sfoglia la gerarchia o cerca il progetto o la cartella a cui vuoi passare. Se fai clic su una risorsa in questo selettore, il contesto globale cambia, influendo sulle risorse visibili in altre pagine di servizio (come Compute Engine o Cloud Storage).

gcloud

Per visualizzare i dettagli di una cartella, utilizza il comando gcloud resource-manager folders describe:

gcloud resource-manager folders describe FOLDER_ID

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

Per elencare le cartelle secondarie di una risorsa organizzazione, utilizza il comando gcloud resource-manager folders list:

gcloud resource-manager folders list \
    --organization=ORGANIZATION_ID

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

Per elencare le cartelle secondarie di una risorsa cartella, utilizza il comando gcloud resource-manager folders list:

gcloud resource-manager folders list \
    --folder=FOLDER_ID

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

Per elencare i progetti in una risorsa organizzazione o cartella, utilizza il comando gcloud projects list con il flag --filter:

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

Sostituisci RESOURCE_ID con l'ID della risorsa organizzazione o cartella per cui vuoi visualizzare un elenco di progetti secondari.

REST

La richiesta curl per ottenere le cartelle:

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

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, ad esempio organizations/123 o folders/123.

Aggiorna cartelle

Per aggiornare il nome visualizzato di una cartella, devi disporre del ruolo Folder Editor (roles/resourcemanager.folderEditor) o Amministratore cartelle (roles/resourcemanager.folderAdmin) sulla cartella.

Console

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

    Apri la pagina Gestisci risorse

  2. Fai clic sulla freccia accanto al nome dell'organizzazione per espandere la visualizzazione ad albero e visualizzare le cartelle secondarie.

  3. Nella riga della cartella che vuoi aggiornare, fai clic sul menu Azioni alla fine della riga e poi su Impostazioni.

  4. Inserisci il nuovo nome della cartella e fai clic su Salva.

gcloud

Per aggiornare il nome visualizzato di una cartella, utilizza il comando gcloud resource-manager folders update:

gcloud resource-manager folders update FOLDER_ID \
   --display-name="NEW_DISPLAY_NAME"

Sostituisci quanto segue:

  • FOLDER_ID: l'ID della cartella che vuoi aggiornare.
  • NEW_DISPLAY_NAME: il nuovo nome visualizzato della cartella.

REST

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • FOLDER_ID: l'ID cartella Google Cloud
  • NEW_DISPLAY_NAME: il nuovo nome visualizzato della cartella

Metodo HTTP e URL: 

PATCH https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName

Corpo JSON della richiesta: 

{
  "displayName": "NEW_DISPLAY_NAME"
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName"

PowerShell

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "operations/fc.1234567890abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
    "displayName": "NEW_DISPLAY_NAME",
    "operationType": "UPDATE",
    "resourceName": "folders/FOLDER_ID"
  },
  "done": false
}

Spostare una cartella in un'altra cartella

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

Console

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

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

    Apri la console Google Cloud

  2. Seleziona la risorsa Organizzazione dal menu a discesa Organizzazione in alto a sinistra della pagina.
  3. Fai clic sulla riga della cartella per selezionarla dall'elenco 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 vuoi spostare la cartella.
  6. Fai clic su Sposta.

gcloud

Per spostare una cartella nella risorsa organizzazione, esegui questo comando in Google Cloud CLI:

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

Sostituisci quanto segue:

  • FOLDER_ID: l'ID della cartella che vuoi spostare.
  • PARENT_ID: l'ID della risorsa organizzazione padre.

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 che vuoi spostare.
  • PARENT_ID: l'ID della cartella principale.

REST

Il file JSON della richiesta:

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

La richiesta curl per spostare la 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 stai spostando un'altra cartella, ad esempio 98765.
  • DISPLAY_NAME: il nome visualizzato della cartella da spostare, ad esempio "La mia cartella fantastica".

La risposta di Sposta cartella:

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

La richiesta curl Get Operation:

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

La risposta Get Operation:

{
  "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"
  }
}

Elimina cartelle

Per eliminare una cartella, devi disporre del ruolo Autore cartelle (roles/resourcemanager.folderEditor) o Amministratore cartelle (roles/resourcemanager.folderAdmin) sulla cartella.

Console

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

    Apri la pagina Gestisci risorse

    Nella console Google Cloud , vai alla pagina Gestisci risorse.

  2. Fai clic sulla freccia accanto al nome dell'organizzazione per espandere la visualizzazione ad albero e visualizzare le cartelle secondarie.

  3. Nella riga della cartella che vuoi eliminare, fai clic sul menu Azioni alla fine della riga e poi su Elimina.

  4. Nella finestra di dialogo di conferma, digita l'ID o il nome della cartella per confermare e fai clic su Elimina.

gcloud

Per eliminare una cartella, esegui questo comando:

gcloud resource-manager folders delete FOLDER_ID

Sostituisci quanto segue:

  • FOLDER_ID: l'ID della cartella che vuoi eliminare.

REST

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • FOLDER_ID: l'ID cartella Google Cloud

Metodo HTTP e URL: 

DELETE https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando: 

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID"

PowerShell

Esegui questo comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "operations/fc.1234567890abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
    "operationType": "DELETE",
    "resourceName": "folders/FOLDER_ID"
  },
  "done": false
}

Informazioni aggiuntive

Quando elimini una cartella, questa entra in uno stato di eliminazione temporanea per un periodo di conservazione di 30 giorni prima di essere eliminata definitivamente.

Stato di eliminazione temporanea: durante il periodo di conservazione di 30 giorni, la cartella viene contrassegnata per l'eliminazione e non è più attiva. Non puoi creare nuovi progetti o sottocartelle all'interno di una cartella eliminata temporaneamente.

Stato di eliminazione definitiva: dopo 30 giorni, Google Cloud rimuove definitivamente la cartella e i relativi metadati. L'operazione è irreversibile.

Annullamento dell'eliminazione: se elimini per errore una cartella, puoi ripristinarla entro 30 giorni utilizzando il comando gcloud resource-manager folders undelete o l'API.

Prerequisiti e vincoli

  • La cartella deve essere vuota: non puoi eliminare una cartella che contiene ancora progetti o sottocartelle attivi. Devi prima spostare o eliminare tutte le risorse secondarie.
  • Autorizzazioni richieste: per eliminare o annullare l'eliminazione di una cartella, devi disporre del ruolo Folder Editor (roles/resourcemanager.folderEditor) o Amministratore cartelle (roles/resourcemanager.folderAdmin).

Cerca

Per cercare cartelle che corrispondono a una query specifica, utilizza il comando gcloud alpha resource-manager folders search e passa la condizione di ricerca nel flag --query. L'ambito di ricerca include tutte le cartelle che hai l'autorizzazione di visualizzare.

Ad esempio, per cercare cartelle con nomi visualizzati che iniziano con vij, come vijeta o vijay-folder, esegui il seguente comando:

gcloud alpha resource-manager folders search --query="displayName:vij*"

Per cercare le cartelle in attesa di eliminazione, esegui questo comando:

gcloud alpha resource-manager folders search --query="state:DELETE_REQUESTED"

Per restituire tutte le cartelle che hai l'autorizzazione di visualizzare, esegui il comando gcloud alpha resource-manager folders search senza il flag --query:

gcloud alpha resource-manager folders search

Passaggi successivi