Questa pagina descrive i bucket, una risorsa di Cloud Storage. Per una panoramica generale del funzionamento di Cloud Storage, consulta la panoramica del prodotto Cloud Storage.
Bucket
I bucket sono i container di base in cui vengono archiviati i dati. Tutto ciò che viene archiviato in Cloud Storage deve essere contenuto in un bucket. Puoi usare i bucket per organizzare i tuoi dati e controllarne l'accesso, ma, a differenza di directory e cartelle, non puoi nidificare i bucket.
Non esiste un limite al numero di bucket che puoi avere in un progetto o posizione.
- Esistono tuttavia limiti alla frequenza con cui puoi creare o eliminare i bucket.
Quando crei un bucket, devi assegnargli un nome univoco a livello globale e una posizione geografica in cui vengono archiviati il bucket e i relativi contenuti.
- Non puoi modificare il nome o la posizione di un bucket esistente. In alternativa, puoi creare un nuovo bucket con le proprietà che ti interessano e spostare i contenuti dal vecchio al nuovo bucket. Per una guida passo passo, consulta Spostare e rinominare i bucket.
- I prezzi (ad esempio gli addebiti per l'archiviazione dei dati, l'elaborazione dei dati e il trasferimento di dati in uscita sulla rete) dipendono da fattori quali la posizione del bucket e le classi di archiviazione degli oggetti al suo interno. Per maggiori dettagli, consulta la pagina Prezzi di Cloud Storage.
- Puoi utilizzare Identity and Access Management (IAM) per controllare l'accesso ai singoli bucket.
Attivare lo spazio dei nomi gerarchico nei bucket
Quando crei un bucket, hai la possibilità di attivare lo spazio dei nomi gerarchico per il bucket. I bucket con spazio dei nomi gerarchico abilitato hanno una struttura di archiviazione ottimizzata simile a un file system, che organizza gli oggetti all'interno di una gerarchia di cartelle. Ciò offre prestazioni, coerenza e facilità di gestione migliori, in particolare per i carichi di lavoro che richiedono un uso intensivo dei dati e sono orientati ai file. Per informazioni sull'abilitazione dello spazio dei nomi gerarchico, consulta Creare bucket con lo spazio dei nomi gerarchico abilitato.
Nomi dei bucket
I nomi dei bucket devono soddisfare i seguenti requisiti:
- I nomi dei bucket possono contenere solo lettere minuscole, caratteri numerici, trattini (
-
), trattini bassi (_
) e punti (.
). Gli spazi non sono consentiti. I nomi che contengono punti richiedono la verifica. - I nomi dei bucket devono iniziare e terminare con un numero o con una lettera.
- I nomi dei bucket possono contenere da 3 a 63 caratteri. I nomi che includono punti possono contenere fino a 222 caratteri, ma ogni singolo componente separato da un punto non può essere più lungo di 63 caratteri.
- I nomi dei bucket non possono essere rappresentati da un indirizzo IP con notazione decimale separata da punti (ad esempio 192.168.5.4).
- I nomi dei bucket non possono iniziare con il prefisso "goog".
- I nomi dei bucket non devono contenere la parola "google" o parole simili che potrebbero sembrare errori di digitazione di "google", ad esempio "g00gle".
Considerazioni sul nome del bucket
I nomi dei bucket si trovano in un unico spazio dei nomi condiviso da tutti gli utenti di Cloud Storage. Ciò significa che:
Ogni nome del bucket deve essere univoco a livello globale.
Se provi a creare un bucket con un nome che appartiene già a un bucket esistente, ad esempio
example-bucket
, Cloud Storage risponde con un messaggio di errore.I nomi dei bucket sono visibili pubblicamente.
Non utilizzare ID utente, indirizzi email, nomi di progetti, numeri di progetti o informazioni che consentono l'identificazione personale (PII) nei nomi dei bucket perché chiunque può verificare l'esistenza di un bucket.
Una volta eliminato un bucket, chiunque può riutilizzarne il nome per un nuovo bucket.
Il tempo necessario per rendere nuovamente disponibile il nome di un bucket eliminato è solitamente nell'ordine di secondi. Tuttavia, tieni presente quanto segue:
- Se elimini il progetto che contiene il bucket, viene eliminato anche il bucket, pertanto il nome del bucket potrebbe non essere rilasciato per settimane o più.
- Se un nuovo bucket con lo stesso nome viene creato in una posizione diversa e
entro 10 minuti dall'eliminazione del vecchio bucket, le richieste effettuate al nuovo
bucket durante questo periodo di 10 minuti potrebbero non andare a buon fine con un
404-Bucket Not Found
errore. - Se le richieste passano tramite l'API XML, i tentativi di creare un bucket che riutilizza un nome in una nuova posizione potrebbero non riuscire con un errore
404-Bucket Not Found
per un massimo di 10 minuti dopo l'eliminazione del vecchio bucket.
Puoi utilizzare il nome di un bucket in un record DNS come parte di un reindirizzamento
CNAME
oA
.A tale scopo, il nome del bucket deve essere conforme alle convenzioni di denominazione DNS standard. Ciò significa che il nome del bucket non deve contenere trattini bassi (
_
) né un punto accanto a un altro punto o a un trattino. Ad esempio,..
,-.
e.-
sono combinazioni di caratteri non valide all'interno dei nomi DNS.
Esempi di nomi di bucket
Di seguito sono riportati alcuni esempi di nomi di bucket validi:
my-travel-maps
0f75d593-8e7b-4418-a5ba-cb2970f0b91e
test.example.com
(è necessaria la verifica della proprietà perexample.com
)
Di seguito sono riportati alcuni esempi di nomi di bucket non validi:
My-Travel-Maps
(contiene lettere maiuscole)my_google_bucket
(contiene "google")test bucket
(contiene uno spazio)
Passaggi successivi
- Crea bucket Cloud Storage.
- Rinomina un bucket esistente.
- Scopri di più sui metadati associati a un bucket.
- Carica un oggetto.