In questa pagina vengono descritti i bucket, una risorsa di Cloud Storage. Per un uso generico per una panoramica del funzionamento di Cloud Storage, consulta 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 utilizzare bucket per organizzare i dati e controllarne l'accesso, ma a differenza non puoi nidificare i bucket.
Non esiste un limite al numero di bucket che puoi avere in un progetto o in una posizione.
- Esistono tuttavia limiti alla frequenza con cui puoi creare o eliminare i bucket.
Quando crei un bucket, gli assegni un nome univoco a livello globale e un posizione geografica in cui sono archiviati il bucket e i relativi contenuti.
- Non puoi modificare il nome o la località di un bucket esistente. Invece, puoi creare un nuovo bucket con le proprietà che preferisci e spostare i contenuti dal vecchio bucket a quello nuovo. Consulta Spostamento e ridenominazione dei bucket per una guida passo passo.
- Prezzi (ad esempio addebiti per l'archiviazione e l'elaborazione dei dati e la il trasferimento dei dati in uscita) dipende da fattori quali la località di archiviazione delle classi di archiviazione degli oggetti al suo interno. Per ulteriori dettagli, vedi 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 (anteprima) per il bucket. I bucket con spazio dei nomi gerarchico abilitato hanno uno spazio dei nomi una struttura di archiviazione simile a un file system, che organizza gli oggetti all'interno nella gerarchia delle cartelle. Ciò fornisce prestazioni, coerenza e facilità migliori del machine learning, soprattutto per i carichi di lavoro ad alta intensità di dati e orientati ai file. Per informazioni sull'abilitazione dello spazio dei nomi gerarchico. Consulta Creare e gestire gestire i bucket con uno 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. Per i nomi che contengono punti è necessaria 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 possono contenere "google" o errori ortografici più comuni, come "g00gle".
Considerazioni sui nomi dei bucket
I nomi dei bucket risiedono in un singolo spazio dei nomi condiviso da tutti 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 progetto, numeri di progetto o informazioni che consentono l'identificazione personale (PII) nei nomi dei bucket 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 è generalmente nell'ordine dei secondi; Tuttavia, tieni presente quanto segue:
- Se elimini il progetto che contiene il bucket, elimina anche il bucket, il nome del bucket potrebbe non essere rilasciato per settimane o più a lungo.
- Se viene creato un nuovo bucket con lo stesso nome in una località diversa
entro 10 minuti dall'eliminazione del vecchio bucket, le richieste fatte al nuovo
durante questo periodo di 10 minuti potrebbe non riuscire e
404-Bucket Not Found
errore. - Se le tue richieste passano attraverso l'API XML, tenta di creare un bucket
che riutilizza un nome in una nuova posizione potrebbe non riuscire con un
404-Bucket Not Found
errore per un massimo di 10 minuti dopo la data eliminazione.
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 alla denominazione DNS standard le convenzioni dell'IA. Ciò significa che il nome del bucket non deve contenere trattini bassi (
_
) o avere una mestruazione accanto a un'altra mestruazione o a un trattino. Ad esempio,..
,-.
e.-
sono combinazioni di caratteri non valide all'interno dei nomi DNS.
Nomi di bucket di esempio
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.
- Rinominare un bucket esistente.
- Scopri di più sui metadati associati a un bucket.
- Carica un oggetto.