Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina descrive i bucket, una risorsa 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 come oggetti.
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 in una
posizione.
Non puoi modificare il nome di un bucket esistente. In alternativa, puoi creare un nuovo bucket con il nome 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 (ad esempio i costi per l'archiviazione dei dati, l'elaborazione dei dati e il trasferimento di 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 la pagina
Prezzi di Cloud Storage.
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 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 puntata
(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, ad esempio "g00gle".
Esempi di nomi di bucket
Di seguito sono riportati alcuni esempi di nomi di bucket validi:
Di seguito sono riportati alcuni esempi di nomi bucket non validi:
My-Travel-Maps (contiene lettere maiuscole)
my_google_bucket (contiene "google")
test bucket (contiene uno spazio)
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 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 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 affinché il nome di un bucket eliminato torni disponibile è
in genere dell'ordine di secondi. Tuttavia, tieni presente quanto segue:
Se elimini il progetto che contiene il bucket, eliminando di fatto anche il bucket, il nome del bucket potrebbe non essere rilasciato per settimane o più.
Se qualcuno riutilizza il nome del tuo bucket, non puoi ripristinare il bucket eliminato
anche se l'eliminazione temporanea è abilitata.
Se viene creato un nuovo bucket con lo stesso nome in una posizione diversa e
entro 10 minuti dall'eliminazione del bucket precedente, le richieste effettuate al nuovo
bucket durante questo periodo di 10 minuti potrebbero non riuscire e restituire 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 posizione potrebbero non riuscire con un
errore 404-Bucket Not Found per un massimo di 10 minuti dopo l'eliminazione
del vecchio bucket.
Se qualcuno riutilizza il nome del tuo bucket, potrebbe inavvertitamente
ricevere dati o richieste destinati al bucket originale eliminato. Per
mitigare questo rischio, considera le seguenti best practice:
Quando crei bucket, utilizza una convenzione di denominazione efficace che non sia facile da
indovinare o prevedere.
Quando elimini i bucket, assicurati di rimuovere tutti i riferimenti al nome del bucket eliminato, ad esempio dalla documentazione esterna o dai repository open source.
Se non hai più bisogno di un bucket, valuta la possibilità di svuotare tutti gli oggetti
dal bucket e di conservarlo anziché eliminarlo.
Puoi utilizzare un nome bucket in un record DNS come parte di un reindirizzamento CNAME o A.
Per farlo, il nome del bucket deve essere conforme alle convenzioni di denominazione DNS standard. Ciò significa che il nome del bucket non deve utilizzare trattini bassi
(_) né avere 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.
Accedere ai dati nei bucket utilizzando cartelle o directory
Sebbene Cloud Storage memorizzi dati non strutturati sotto forma di oggetti, alcune funzionalità consentono di accedere ai dati e gestirli utilizzando cartelle o directory.
Spazio dei nomi gerarchico
Quando crei bucket, puoi facoltativamente attivare lo spazio dei nomi gerarchico
per il bucket, che ti consente di utilizzare le cartelle per archiviare gli oggetti
come in un file system. L'organizzazione degli oggetti in cartelle semplifica l'esecuzione di operazioni su grandi quantità di dati, migliorando le prestazioni, la coerenza e la facilità di gestione. L'utilizzo di bucket con lo spazio dei nomi gerarchico abilitato è
particolarmente vantaggioso quando si lavora con workload
con uso intensivo dei dati e orientati ai file.
Cloud Storage FUSE è un adattatore FUSE che consente di montare e accedere ai bucket come file system locali, in modo che le applicazioni possano leggere e scrivere oggetti nel bucket utilizzando la semantica standard del file system. Cloud Storage FUSE ti consente di archiviare i dati in Cloud Storage con tutti i vantaggi del servizio, mantenendo la possibilità di accedere a questi dati utilizzando il codice dell'applicazione senza dover apportare modifiche.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-05 UTC."],[],[],null,["# About Cloud Storage buckets\n\nThis page describes buckets, a resource in Cloud Storage. For a general\noverview of how Cloud Storage works, see the\n[Cloud Storage product overview](/storage/docs/introduction).\n\nBuckets\n-------\n\nBuckets are the basic containers that hold your data as [objects](/storage/docs/objects).\nEverything that you store in Cloud Storage must be contained in a\nbucket. You can use buckets to organize your data and control access to your\ndata, but unlike directories and folders, you cannot nest buckets.\n\n- There is no limit to the number of buckets you can have in a project or\n [location](/storage/docs/locations).\n\n - There are, however, [limits to the rate you can create or delete buckets](/storage/quotas).\n- When you [create a bucket](/storage/docs/creating-buckets), you give it a [globally-unique name](#naming) and a\n [geographic location](/storage/docs/locations) where the bucket and its contents are stored.\n\n - You cannot change the name of an existing bucket. Instead, you can create a new bucket with the name you want and move the contents from the old bucket to the new bucket. See [Move and rename buckets](/storage/docs/moving-buckets) for a step-by-step guide.\n\n\u003c!-- --\u003e\n\n- Pricing (such as charges for data storage, data processing, and network outbound data transfer) depends on factors such as the bucket's location and the storage classes of objects within it. For more details, see [Cloud Storage pricing](/storage/pricing).\n\n\u003c!-- --\u003e\n\n- You can use [Identity and Access Management (IAM)](/storage/docs/access-control/iam) to control access to individual buckets.\n\nBucket names\n------------\n\nYour bucket names must meet the following requirements:\n\n- Bucket names can only contain lowercase letters, numeric characters, dashes (`-`), underscores (`_`), and dots (`.`). Spaces are not allowed. Names containing dots require [verification](/storage/docs/domain-name-verification).\n- Bucket names must start and end with a number or letter.\n- Bucket names must contain 3-63 characters. Names containing dots can contain up to 222 characters, but each dot-separated component can be no longer than 63 characters.\n- Bucket names cannot be represented as an IP address in dotted-decimal notation (for example, 192.168.5.4).\n- Bucket names cannot begin with the \"goog\" prefix.\n- Bucket names cannot contain \"google\" or close misspellings, such as \"g00gle\".\n\n### Example bucket names\n\nThe following are examples of valid bucket names:\n\n- `my-travel-maps`\n- `0f75d593-8e7b-4418-a5ba-cb2970f0b91e`\n- `test.example.com` (Requires [verification of ownership for `example.com`](/storage/docs/domain-name-verification))\n\nThe following are examples of invalid bucket names:\n\n- `My-Travel-Maps` (contains uppercase letters)\n- `my_google_bucket` (contains \"google\")\n- `test bucket` (contains a space)\n\n### Bucket name considerations\n\n- Bucket names reside in a single namespace that is shared by all\n Cloud Storage users. This means that:\n\n - Every bucket name must be globally unique.\n\n If you try to create a bucket with a name that already belongs to an\n existing bucket, such as `example-bucket`, Cloud Storage\n responds with an error message.\n - Bucket names are publicly visible.\n\n Don't use user IDs, email addresses, project names, project numbers, or\n any personally identifiable information (PII) in bucket names because\n anyone can probe for the existence of a bucket.\n- Once you delete a bucket, anyone can reuse its name for a new bucket.\n\n - The time it takes a deleted bucket's name to become available again is\n typically on the order of seconds; however, keep in mind the following:\n\n - If you delete the project that contains the bucket, which effectively\n deletes the bucket as well, the bucket name may not be released for weeks\n or longer.\n\n - If someone reuses your bucket's name, you cannot restore your deleted\n bucket even if the bucket has soft delete enabled.\n\n - If a new bucket with the same name is created in a different location and\n within 10 minutes of the old bucket's deletion, requests made to the new\n bucket during this 10 minute timeframe might fail with a\n `404-Bucket Not Found` error.\n\n - If your requests go through the [XML API](/storage/docs/xml-api), attempts to create a bucket\n that reuses a name in a new location might fail with a\n `404-Bucket Not Found` error for up to 10 minutes after the old bucket's\n deletion.\n\n - If someone reuses your bucket's name, they could inadvertently\n receive data or requests intended for your original deleted bucket. To\n mitigate this risk, consider the following best practices:\n\n - When creating buckets, use a strong naming convention that's not easy to\n guess or predict.\n\n - When deleting buckets, make sure to remove all references of the\n deleted bucket's name, such as from external documentation or open\n source repositories.\n\n - If you no longer need a bucket, consider emptying all objects from\n the bucket and keeping the bucket instead of deleting it.\n\n- You can use a bucket name in a DNS record as part of a `CNAME` or `A`\n redirect.\n\n In order to do so, your bucket name should conform to standard DNS naming\n conventions. This means that your bucket name shouldn't use underscores\n (`_`) or have a period next to another period or dash. For example, `..`,\n `-.`, and `.-` are invalid character combinations within DNS names.\n\nAccess data in buckets by using folders or directories\n------------------------------------------------------\n\nAlthough Cloud Storage stores unstructured data in the form of objects,\nsome features let you access and manage your data using folders or directories.\n\n### Hierarchical namespace\n\nWhen you create buckets, you can optionally enable [hierarchical namespace](/storage/docs/hns-overview)\nfor the bucket, which lets you use [folders](/storage/docs/folders-overview) to store your objects in\na file system manner. Organizing your objects into folders makes it easier to\nrun operations on large scales of data, improving performance, consistency,\nand ease of management. Using buckets with hierarchical namespace enabled is\nespecially beneficial when working with data-intensive and file-oriented\nworkloads.\n\nTo get started using hierarchical namespace, see\n[Create buckets with hierarchical namespace enabled](/storage/docs/create-hns-bucket).\n\n### Cloud Storage FUSE\n\n[Cloud Storage FUSE](/storage/docs/cloud-storage-fuse/overview#overview) is a FUSE adapter that lets you mount and access buckets as\nlocal file systems, so applications can read and write objects in your bucket\nusing standard file system semantics. Cloud Storage FUSE lets you store your data\nin Cloud Storage with all the service's benefits, all while retaining\nthe ability to access that data using your application's code without needing\nchanges.\n\nTo learn how to use Cloud Storage FUSE, see the [Cloud Storage FUSE quickstart](/storage/docs/cloud-storage-fuse/quickstart-mount-bucket).\n\nWhat's next\n-----------\n\n- [Create Cloud Storage buckets](/storage/docs/creating-buckets).\n- [Rename an existing bucket](/storage/docs/moving-buckets).\n- Learn about the [metadata associated with a bucket](/storage/docs/bucket-metadata).\n- [Upload an object](/storage/docs/uploading-objects)."]]
