Questa pagina descrive come visualizzare i dettagli delle cartelle, aggiornare le impostazioni delle cartelle ed eliminare le cartelle utilizzando la Google Cloud console, Google Cloud CLI o l'API. Scopri come modificare i nomi visualizzati delle cartelle e gestire il posizionamento delle cartelle all'interno della gerarchia della tua organizzazione.
Elencare le cartelle e visualizzare i dettagli delle cartelle
Per elencare le cartelle o visualizzare i metadati di una cartella specifica, come il nome visualizzato, l'ID del parent e lo stato del ciclo di vita, devi avere il ruolo Visualizzatore cartelle (roles/resourcemanager.folderViewer) o il ruolo Visualizzatore organizzazione (roles/resourcemanager.organizationViewer).
Console
Nella Google Cloud console, apri la pagina Gestisci risorse.
L'elenco delle risorse mostra la gerarchia come una tabella. Seleziona la risorsa dell'organizzazione.
Fai clic sulla freccia accanto al nome dell'organizzazione per espandere la visualizzazione ad albero e visualizzare le cartelle secondarie.
Per eseguire azioni come spostare, eliminare o visualizzare le impostazioni, fai clic su Azioni alla fine di la riga per la risorsa specifica.
Utilizza la barra Filtra nella parte superiore dell'elenco delle risorse per cercare le risorse per nome, ID o etichetta.
Utilizzo del selettore di progetti
Il selettore di progetti si trova nella barra di navigazione e non fa parte dell'interfaccia principale della pagina Resource Manager. Utilizzalo per passare dal contesto globale attivo a un progetto o una cartella specifici.
Fai clic sul selettore di progetti. Nella finestra di dialogo visualizzata, seleziona la tua organizzazione dal menu a discesa per filtrare i risultati.
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, il che influisce sulle risorse visibili nelle altre pagine dei servizi (come Compute Engine o Cloud Storage).
gcloud
Per visualizzare i dettagli di una cartella, utilizza il comando 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 dell'organizzazione, utilizza il comando resource-manager folders list.
gcloud resource-manager folders list \
--organization ORGANIZATION_ID
Sostituisci ORGANIZATION_ID con l'ID della risorsa dell'organizzazione per la quale vuoi visualizzare un elenco di cartelle secondarie.
Per elencare le cartelle secondarie di una risorsa cartella, utilizza il comando resource-manager folders list.
gcloud resource-manager folders list \
--folder FOLDER_ID
Sostituisci FOLDER_ID con l'ID della risorsa cartella per la quale vuoi visualizzare un elenco di cartelle secondarie.
Per elencare i progetti in una risorsa dell'organizzazione o della cartella o in una cartella, utilizza il comando projects list con l'argomento filter.
gcloud projects list \
--filter=" parent.id: 'RESOURCE_ID' "
Sostituisci RESOURCE_ID con l'ID della risorsa dell'organizzazione o della cartella per la quale vuoi visualizzare un elenco di progetti secondari.
REST
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_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 parent in cui stai creando la cartella, ad esempio organizations/123 o folders/123.
Aggiornare le cartelle
Per aggiornare il nome visualizzato di una cartella, devi avere il ruolo Editor cartelle (roles/resourcemanager.folderEditor) o il ruolo Amministratore cartelle (roles/resourcemanager.folderAdmin) nella cartella.
Console
Nella Google Cloud console, apri la pagina Gestisci risorse.
Fai clic sulla freccia accanto al nome dell'organizzazione per espandere la visualizzazione ad albero e visualizzare le cartelle secondarie.
Nella riga della cartella che vuoi aggiornare, fai clic sul menu Azioni alla fine di riga e poi su Impostazioni.
Inserisci il nuovo nome della cartella e fai clic su Salva.
gcloud
Per aggiornare il nome visualizzato di una cartella:
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' Google Cloud ID della cartella
- 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 avere l'autorizzazione resourcemanager.folders.move sia per la cartella di origine sia per quella di destinazione.
Console
La procedura per spostare le cartelle in altre cartelle nella console è simile a quella per spostare i progetti.
- Nella Google Cloud console, apri la pagina Gestisci risorse.
- Seleziona la risorsa dell'organizzazione dal menu a discesa Organizzazione in alto a sinistra nella pagina.
- Fai clic sulla riga della cartella per selezionarla dall'elenco di progetti e cartelle.
- Fai clic sul menu opzioni (i tre punti verticali) nella riga e poi su Sposta.
- Fai clic su Sfoglia per selezionare la cartella in cui vuoi spostare la cartella.
- Fai clic su Sposta.
gcloud
Per spostare una cartella nella risorsa dell'organizzazione, esegui il comando seguente 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 dell'organizzazione parent.
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 risorsa dell'organizzazione o della cartella parent.
REST
Il JSON della richiesta:
request_json= '{
destinationParent: "folders/DESTINATION_FOLDER_ID"
}'
La richiesta curl 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 stai
spostando un'altra cartella, ad esempio
98765. - DISPLAY_NAME: il nome visualizzato della cartella che viene spostata, ad esempio "La mia cartella fantastica".
La risposta Sposta cartella:
{
"name": "operations/fm.1234567890",
"metadata": {
"@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
"displayName": "DISPLAY_NAME",
"operationType": "MOVE"
}
}
La richiesta curl Recupera operazione:
curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fm.1234567890
La risposta Recupera operazione:
{
"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"
}
}
Eliminare le cartelle
Per eliminare una cartella, devi avere il ruolo Editor cartelle (roles/resourcemanager.folderEditor) o il ruolo Amministratore cartelle (roles/resourcemanager.folderAdmin) nella cartella.
Console
Nella Google Cloud console, apri la pagina Gestisci risorse.
Nella Google Cloud console, vai alla pagina Gestisci risorse.Fai clic sulla freccia accanto al nome dell'organizzazione per espandere la visualizzazione ad albero e visualizzare le cartelle secondarie.
Nella riga della cartella che vuoi eliminare, fai clic sul menu Azioni alla fine di riga e poi su Elimina.
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 il comando seguente:
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' Google Cloud ID della cartella
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 passa allo stato di eliminazione temporanea per un periodo di conservazione di 30 giorni prima di essere eliminata definitivamente o eliminata in modo definitivo.
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.
Annullare l'eliminazione: se elimini accidentalmente una cartella, puoi ripristinarla entro la
finestra di 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 avere il ruolo Editor cartelle (
roles/resourcemanager.folderEditor) o Amministratore cartelle (roles/resourcemanager.folderAdmin).
Cerca
Per cercare le cartelle che corrispondono 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 visualizzate utilizzando il comando gcloud folders search.
gcloud folders search
<table output showing all viewable folders>
Passaggi successivi
- Scopri di più sulla gestione dei progetti all'interno delle cartelle.
- Scopri di più sui ruoli e sulle autorizzazioni per le cartelle.