Questa pagina descrive come visualizzare i dettagli delle cartelle, aggiornare le impostazioni delle cartelle ed eliminare le cartelle utilizzando la console Google Cloud , Google Cloud CLI o l'API. Scopri come modificare i nomi di visualizzazione delle cartelle e gestire il posizionamento delle cartelle all'interno della gerarchia della tua organizzazione.
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 elemento padre e lo stato del ciclo di vita, devi disporre del ruolo Visualizzatore cartelle (roles/resourcemanager.folderViewer) o del ruolo Visualizzatore organizzazione (roles/resourcemanager.organizationViewer).
Console
Nella console Google Cloud , apri la pagina Gestisci risorse.
L'elenco delle risorse mostra la gerarchia sotto forma di tabella. Seleziona la risorsa della tua organizzazione.
Fai clic sulla freccia accanto al nome dell'organizzazione per espandere la visualizzazione ad albero e visualizzare le relative cartelle secondarie.
Per eseguire azioni, ad esempio spostare, eliminare o visualizzare le impostazioni, fai clic su Azioni alla fine della riga per quella risorsa specifica.
Utilizza la barra Filtro nella parte superiore dell'elenco delle risorse per cercare risorse per nome, ID o etichetta.
Utilizzo del selettore di progetti
Utilizza il selettore di progetti nella barra di navigazione in alto per passare il contesto attivo a un progetto o una cartella specifici.
Nella barra di navigazione in alto della console Google Cloud , fai clic sul selettore di progetti. Si tratta del menu a discesa accanto al logo Google Cloud.
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 e influisce sulle risorse visibili in altre pagine di servizio (come Compute Engine o Cloud Storage).
gcloud
Per ottenere 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 organizzazione, utilizza il comando 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 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 un'organizzazione, una risorsa cartella o 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 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 principale
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 disporre del ruolo Editor cartella (roles/resourcemanager.folderEditor)
o del ruolo Amministratore cartelle (roles/resourcemanager.folderAdmin) per la cartella.
Console
Nella console Google Cloud , apri la pagina Gestisci risorse.
Fai clic sulla freccia accanto al nome dell'organizzazione per espandere la visualizzazione ad albero e visualizzare le relative cartelle secondarie.
Nella riga della cartella da aggiornare, fai clic sul menu Azioni alla fine della 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 da aggiornare.NEW_DISPLAY_NAME: il nuovo nome visualizzato per la cartella.
REST
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- FOLDER_ID: l' Google Cloud ID cartella
- NEW_DISPLAY_NAME: il nuovo nome visualizzato per la 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 sia per la cartella di origine sia per quella di destinazione.
Console
La procedura per spostare le cartelle in altre cartelle nella console è simile allo spostamento dei progetti.
- Nella console Google Cloud , apri la pagina Gestisci risorse.
- Seleziona la risorsa dell'organizzazione dal menu a discesa Organizzazione in alto a sinistra della pagina.
- Fai clic sulla riga della cartella per selezionarla dall'elenco di progetti e cartelle.
- Fai clic sul menu opzioni (i tre puntini 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 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 dell'organizzazione principale.
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 o della cartella dell'organizzazione principale.
REST
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 da spostare, ad esempio "La mia fantastica cartella".
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 Get Operation:
curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fm.1234567890
La risposta di Recupero 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 cartelle
Per eliminare una cartella, devi disporre del ruolo Editor cartella (roles/resourcemanager.folderEditor)
o del ruolo Amministratore cartelle (roles/resourcemanager.folderAdmin) per la cartella.
Console
Nella console Google Cloud , apri la pagina Gestisci risorse.
Nella console Google Cloud , vai alla pagina Gestisci risorse.Fai clic sulla freccia accanto al nome dell'organizzazione per espandere la visualizzazione ad albero e visualizzare le relative cartelle secondarie.
Nella riga della cartella da eliminare, fai clic sul menu Azioni alla fine della 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 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' Google Cloud ID 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 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 la cartella e i relativi metadati vengono rimossi definitivamente. L'operazione è irreversibile.
Annulla 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 ripristinare una cartella, devi disporre del ruolo Editor cartella (
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
sono 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>
Passaggi successivi
- Scopri di più sulla gestione dei progetti all'interno delle cartelle.
- Scopri di più su ruoli e autorizzazioni per le cartelle.