Cartelle gestite

Questa pagina fornisce una panoramica delle cartelle gestite in Cloud Storage. Le cartelle gestite sono un tipo di cartella su cui puoi concedere ruoli IAM, in modo da avere un controllo dell'accesso più granulare su gruppi specifici di oggetti all'interno di un bucket. Le cartelle gestite esistono come risorse all'interno di Cloud Storage e sono diverse da cartelle simulate, che operano con uno spazio dei nomi semplice.

IAM per le cartelle gestite

Quando applichi un criterio IAM a una cartella gestita, l'accesso concesso nel criterio si applica a qualsiasi oggetto all'interno del bucket che utilizza il percorso della cartella gestita come prefisso nel nome dell'oggetto. Ad esempio, se concedi a un'entità il ruolo Visualizzatore oggetti Storage (roles/storage.objectViewer) su una cartella gestita denominata example-managed-folder/, l'entità può visualizzare qualsiasi oggetto all'interno del percorso example-managed-folder, ad esempio example-managed-folder/dog.png o example-managed-folder/cat.jpeg. Quando nidifichi le cartelle gestite, le autorizzazioni concesse tramite i criteri IAM vengono applicate in modo additivo.

I criteri di negazione IAM non possono essere impostati su bucket o cartelle gestite. Possono invece essere impostati solo sulle risorse di progetto, cartella e organizzazione. Inoltre, le cartelle gestite non possono essere specificate come risorsa nelle condizioni dei criteri di negazione IAM. Le condizioni di negazione riconoscono solo le funzioni dei tag delle risorse e i tag non possono essere collegati alle cartelle gestite.

Le cartelle gestite possono essere create solo nei bucket in cui è abilitato l'accesso uniforme a livello di bucket.

Per ulteriori informazioni sulle cartelle gestite, consulta le seguenti pagine:

Nomi delle cartelle gestite

Il nome che assegni a una cartella gestita deve soddisfare i seguenti requisiti:

  • I nomi delle cartelle gestite possono contenere qualsiasi sequenza di caratteri Unicode validi, di lunghezza compresa tra 1 e 1024 byte se codificati in UTF-8.

  • I nomi delle cartelle gestite non possono contenere caratteri di ritorno a capo o avanzamento riga.

  • I nomi delle cartelle gestite devono terminare con /. Un nome di cartella gestita può avere al massimo 15 /. In altre parole, le cartelle gestite possono essere nidificate fino a 15 livelli di profondità.

  • I nomi delle cartelle gestite non possono iniziare con .well-known/acme-challenge/.

  • Le cartelle gestite non possono essere denominate . o ...

Ti consigliamo vivamente di evitare quanto segue nei nomi delle cartelle gestite:

  • Caratteri di controllo non validi in XML 1.0 (#x7F–#x84 e #x86–#x9F): questi caratteri causano problemi di elenco XML quando tenti di elencare le cartelle gestite.

  • I caratteri [, ], * o ?: Google Cloud CLI interpreta questi caratteri come caratteri jolly, quindi includerli nei nomi delle cartelle gestite può rendere difficile o impossibile eseguire operazioni con caratteri jolly con lo strumento. Inoltre, * e ? non sono caratteri validi per i nomi dei file in Windows.

  • Informazioni sensibili o che consentono l'identificazione personale (PII): i nomi delle cartelle gestite sono più visibili dei dati degli oggetti. Ad esempio, i nomi delle cartelle gestite vengono visualizzati negli URL dell'oggetto e quando elenchi gli oggetti in un bucket.

Considerazioni

Quando lavori con le cartelle gestite, tieni presente le seguenti considerazioni:

  • Le cartelle gestite possono essere create al posto delle cartelle simulate, il che significa che puoi creare una cartella gestita e denominarla con il prefisso di un oggetto, a condizione che non esista già una cartella gestita con quel nome. Ad esempio, puoi creare una cartella gestita denominata my-folder/, anche se hai un oggetto esistente denominato my-folder/object.txt. Tieni presente che il criterio IAM sulla cartella gestita my-folder/ verrà applicato a tutti gli oggetti che hanno my-folder/ come prefisso del nome.

  • Puoi creare cartelle gestite secondarie prima della creazione della cartella gestita principale. Ad esempio, puoi creare una cartella gestita denominata my-folder-A/my-folder-B/ senza prima creare una cartella gestita denominata my-folder-A/.

  • Per impostazione predefinita, non puoi eliminare una cartella gestita non vuota che contiene oggetti o altre cartelle gestite secondarie. Puoi ignorare questa regola quando utilizzi il allowNonEmpty parametro in una Delete richiesta API JSON ManagedFolder.

  • I nomi delle cartelle gestite sono visibili nei messaggi di errore e Cloud Audit Logs quando una richiesta di eliminazione di una cartella con una cartella gestita nello stesso percorso non riesce, anche senza le autorizzazioni storage.managedFolders.get o storage.managedFolders.list esplicite.

Passaggi successivi