Informazioni sulle cartelle nei bucket con spazio dei nomi gerarchico abilitato

Questa pagina fornisce informazioni sulle cartelle nei bucket con uno spazio di nomi gerarchico abilitato.

Panoramica

Le cartelle esistono come risorsa nei bucket con lo spazio dei nomi gerarchico attivo. Puoi organizzare gli oggetti all'interno di cartelle in una struttura simile a un sistema di file. Cloud Storage fornisce API di gestione delle cartelle che consentono operazioni come creazione, eliminazione, ridenominazione ed elencazione delle cartelle, nonché recupero dei metadati delle 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 spazio dei nomi gerarchico abilitato supportano tutti i nomi di oggetti validi, inclusi quelli con barre iniziali e finali (/) o barre consecutive. Ogni barra (/) in un nome dell'oggetto rappresenta una cartella. La seguente tabella mostra esempi della relazione tra i nomi degli oggetti e la relativa posizione nella gerarchia delle 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 in una cartella di primo livello denominata dir1/. La cartella di primo livello è diversa dalla cartella principale.
  dir1/	La barra finale nei nomi degli oggetti come dir1/ indica che l'oggetto si trova all'interno della cartella. In questo esempio, il nome dell'oggetto dir1/ corrisponde al nome della cartella principale 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 delle cartelle: i bucket con spazio dei nomi gerarchico abilitato supportano una profondità massima delle cartelle pari a 50. Di conseguenza, i nomi degli oggetti non possono contenere più di 50 barre (/).

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

• Creazione automatica di cartelle: la creazione di un nuovo oggetto comporta automaticamente la creazione di eventuali 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à.

Passaggi successivi

• Creare e gestire le cartelle.
• Rinominare una cartella.
• Ottimizza la gestione delle cartelle.