Questa pagina descrive i bucket, una risorsa in Cloud Storage. Per una panoramica generale di come funziona Cloud Storage, consulta la panoramica del prodotto Cloud Storage.
Bucket
I bucket sono i container di base di cui restano i dati. Tutto ciò che archivi in Cloud Storage deve essere contenuto in un bucket. Puoi utilizzare i bucket per organizzare i dati e controllare l'accesso ai tuoi dati, ma a differenza di directory e cartelle, non puoi nidificare i bucket.
Non è previsto alcun limite al numero di bucket in un progetto o in una località.
- Tuttavia, esistono limiti per la frequenza di creazione o eliminazione dei bucket.
Quando crei un bucket, gli assegni un nome univoco a livello globale e una località geografica in cui sono archiviati il bucket e i suoi contenuti.
- Non puoi modificare il nome o la località di un bucket esistente. In alternativa, puoi creare un nuovo bucket con il nome che preferisci o nella località desiderata e spostare i contenuti dal vecchio bucket al nuovo. Per una guida passo passo, consulta Spostamento e ridenominazione dei bucket.
I prezzi (ad esempio addebiti per archiviazione dei dati, operazioni, tariffe per il recupero e traffico in uscita dalla rete) dipendono da fattori quali la località e la classe di archiviazione del bucket. Per maggiori dettagli, vedi Prezzi di Cloud Storage.
Nomi 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 devono essere verificati. - 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 errori di ortografia come, ad esempio, "g00gle".
Considerazioni sul nome del bucket
I nomi dei bucket si trovano in un singolo spazio dei nomi condiviso da tutti gli utenti di Cloud Storage. Ciò significa che:
Ogni nome di 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, poiché tutti possono eseguire l'indagine sull'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 un nome di un bucket è in genere nell'ordine di alcuni secondi; tuttavia, tieni presente quanto segue:
Se il nuovo bucket viene creato in una località diversa ed entro 10 minuti dall'eliminazione del vecchio bucket, le richieste inviate al nuovo bucket in questo intervallo di 10 minuti potrebbero non riuscire con un errore
404-Bucket Not Found
.Se le tue richieste passano attraverso l'API XML, i tentativi di creare un bucket che riutilizza un nome in una nuova località potrebbero non riuscire con un errore
404-Bucket Not Found
per un massimo di 10 minuti dopo l'eliminazione del vecchio bucket.Se elimini il progetto che contiene il bucket, che elimina in modo efficace anche il bucket, il nome del bucket potrebbe non essere rilasciato per settimane o più a lungo.
Puoi utilizzare il nome di un bucket in un record DNS come parte di un reindirizzamento
CNAME
oA
.A questo scopo, il nome del tuo bucket deve essere conforme alle convenzioni di denominazione DNS standard. Ciò significa che il nome del bucket non deve utilizzare trattini bassi (
_
) né contenere un punto accanto a un altro punto o a un trattino. Ad esempio,..
,-.
e.-
sono combinazioni di caratteri non validi nei nomi DNS.
Esempi di nomi di bucket
Di seguito sono riportati esempi di nomi di bucket validi:
my-travel-maps
0f75d593-8e7b-4418-a5ba-cb2970f0b91e
test.example.com
(richiede la verifica della proprietà perexample.com
)
Di seguito sono riportati 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
- Creare bucket Cloud Storage.
- Rinomina un bucket esistente.
- Scopri di più sui metadati associati a un bucket.
- Caricare un oggetto.