Questa pagina descrive i bucket, una risorsa disponibile in 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 memorizzi in Cloud Storage deve essere contenuto in un bucket. Puoi utilizzare i bucket per organizzare i dati e controllare l'accesso ai dati, ma a differenza di directory e cartelle, non puoi nidificare i bucket.
Non esiste alcun limite al numero di bucket che puoi avere in un progetto o in una località.
- Tuttavia, esistono limiti alla frequenza per la creazione o l'eliminazione di bucket.
Quando crei un bucket, gli attribuisci un nome univoco a livello globale e una località geografica in cui sono archiviati il bucket e i relativi contenuti.
- Non puoi modificare il nome o la località di un bucket esistente. Puoi invece creare un nuovo bucket con le proprietà che preferisci e spostare i contenuti dal vecchio bucket a quello nuovo. Per una guida passo passo, consulta Spostare e rinominare i bucket.
- I prezzi (come gli addebiti per l'archiviazione dei dati, l'elaborazione dei dati e il trasferimento dei dati in uscita dalla rete) dipendono da fattori quali la località del bucket e le classi di archiviazione degli oggetti al suo interno. Per maggiori dettagli, consulta i prezzi di Cloud Storage.
- Puoi utilizzare Identity and Access Management (IAM) per controllare l'accesso a singoli bucket.
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 devono contenere da 3 a 63 caratteri. I nomi che includono punti possono contenere fino a 222 caratteri, ma ogni 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 possono contenere "google" o parole simili, come "g00gle".
Considerazioni sui nomi dei bucket
I nomi dei bucket risiedono in un unico spazio dei nomi condiviso da tutti gli utenti di Cloud Storage. Ciò significa che:
Ciascun nome bucket deve essere univoco a livello globale.
Se provi a creare un bucket con un nome che appartiene già a un bucket esistente, come
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 progetto 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 ripristinare la disponibilità del nome di un bucket eliminato è in genere nell'ordine dei secondi; tuttavia, tieni presente quanto segue:
- Se elimini il progetto che contiene il bucket, il che di fatto elimina anche il bucket, il nome del bucket potrebbe non essere rilasciato per settimane o per un periodo più lungo.
- Se un nuovo bucket con lo stesso nome viene creato in una località diversa entro 10 minuti dall'eliminazione del vecchio bucket, le richieste effettuate al nuovo bucket durante questo periodo di 10 minuti potrebbero non riuscire con un errore
404-Bucket Not Found
. - Se le richieste passano attraverso 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 bucket precedente.
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 (
_
) o punti 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
Ecco alcuni esempi di nomi di bucket validi:
my-travel-maps
0f75d593-8e7b-4418-a5ba-cb2970f0b91e
test.example.com
(richiede la verifica della proprietà perexample.com
)
Ecco 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.