Informazioni sulle cartelle nei bucket con spazio dei nomi gerarchico abilitato

Questa pagina fornisce informazioni sulle cartelle nei bucket con lo spazio dei nomi gerarchico abilitato.

Panoramica

Quando crei un bucket con lo spazio dei nomi gerarchico abilitato, il bucket utilizza una vera struttura di file system anziché uno spazio dei nomi piatto standard. Le cartelle esistono come risorsa nei bucket con lo spazio dei nomi gerarchico abilitato. Utilizzando le cartelle, puoi organizzare gli oggetti in modo più efficace e accedere a funzionalità di directory reali, come la ridenominazione atomica delle cartelle e operazioni efficienti sui metadati.

Puoi gestire le cartelle utilizzando le operazioni di creazione, eliminazione, ridenominazione, elenco e recupero. Per scoprire come eseguire queste operazioni, consulta Creare e gestire cartelle e Rinominare una cartella.

Le cartelle nei bucket con lo spazio dei nomi gerarchico abilitato sono diverse dalle cartelle simulate e dalle cartelle gestite. Le cartelle simulate esistono nei bucket dello spazio dei nomi piatto e le cartelle gestite possono essere applicate sia nei bucket dello spazio dei nomi piatto sia nei bucket con lo spazio dei nomi gerarchico abilitato. Le cartelle gestite vengono utilizzate principalmente per concedere autorizzazioni IAM a gruppi di oggetti. Per ulteriori informazioni su questi altri tipi di cartelle, vedi Tipi di cartelle.

Metadati delle cartelle

I metadati di una cartella contengono informazioni strutturate sulla cartella. Per informazioni dettagliate sui metadati delle cartelle, consulta la risorsa Folder nella documentazione di riferimento dell'API JSON di Cloud Storage.

I componenti chiave dei metadati di una cartella sono i seguenti:

  • bucket: il nome del bucket in cui si trova la cartella. Ad esempio, my-bucket.
  • id: un identificatore univoco per la cartella all'interno del bucket. Ad esempio, hns-bucket/dir1/.
  • kind: il tipo di risorsa. Per una cartella, questo valore è sempre storage#folder.
  • name: il nome della cartella. Ad esempio, dir1/.
  • selfLink: un URL che fa riferimento alla cartella nell'API Cloud Storage.
  • timeCreated: il timestamp della creazione della cartella. Ad esempio, 2023-05-05T16:32:08.878000+00:00.
  • updated: il timestamp dell'ultimo aggiornamento della cartella. Ad esempio, 2024-05-06T16:32:08.878000+00:00.

Considerazioni

Quando crei cartelle, tieni presente quanto segue:

  • Nomi di oggetti e cartelle: i bucket con lo spazio dei nomi gerarchico abilitato supportano tutti i nomi degli oggetti validi, inclusi quelli con barre iniziali, finali (/) o consecutive. Ogni barra (/) nel nome di un oggetto rappresenta una cartella. La seguente tabella mostra esempi della relazione tra i nomi degli oggetti e la loro posizione corrispondente nella gerarchia di cartelle:

    Nome oggetto Posizione nella gerarchia delle cartelle
    foo.txt Ogni bucket include una cartella principale. L'oggetto foo.txt si trova nella cartella principale del bucket.
    dir1/foo.txt L'oggetto foo.txt si trova all'interno di una cartella di primo livello denominata dir1/. La cartella di primo livello è diversa dalla cartella principale.
    dir1/ La barra finale nei nomi degli oggetti, ad esempio dir1/ indica che l'oggetto si trova all'interno della cartella. In questo esempio, il nome dell'oggetto dir1/ è uguale al nome della cartella padre dir1/.
    dir1//foo.txt L'oggetto foo.txt si trova in una cartella di secondo livello denominata dir1//, una cartella secondaria di dir1/.

  • Profondità massima della cartella: i bucket con lo spazio dei nomi gerarchico abilitato supportano una profondità massima della cartella di 50. Di conseguenza, i nomi degli oggetti non possono contenere più di 50 barre (/).

  • Dimensione massima del nome della cartella: 512 byte (codificati in UTF-8).

  • Creazione automatica di cartelle: la creazione di un nuovo oggetto crea automaticamente le cartelle inesistenti specificate nel percorso dell'oggetto. Ad esempio, la creazione di un oggetto denominato dir1/foo.txt crea automaticamente la cartella dir1/ se non esiste già.

  • Informazioni sensibili o che consentono l'identificazione personale (PII): i nomi delle cartelle sono più visibili rispetto ai metadati delle cartelle. Ad esempio, i nomi delle cartelle vengono visualizzati negli URL e quando vengono elencate cartelle o oggetti in un bucket. Non includere informazioni sensibili o PII nei nomi delle cartelle.

  • Interazione con le cartelle gestite: nei bucket con lo spazio dei nomi gerarchico abilitato, puoi gestire il controllo dell'accesso#39;accesso utilizzando le cartelle gestite insieme alle cartelle.

Passaggi successivi