Questa pagina mostra come creare bucket di Cloud Storage. Se non diversamente specificato nella richiesta, i bucket vengono creati in US
più regioni con una classe di archiviazione predefinita Standard Storage e hanno una durata di conservazione di 7 giorni per l'eliminazione temporanea.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per la creazione di un bucket Cloud Storage, chiedi all'amministratore di concederti il ruolo IAM Amministratore Storage (roles/storage.admin
) per il progetto.
Questo ruolo predefinito contiene l'autorizzazione necessaria per creare un bucket. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
storage.buckets.create
storage.buckets.enableObjectRetention
(richiesto solo se si abilitano le configurazioni di conservazione degli oggetti per il bucket)storage.buckets.list
(richiesto solo se si crea un bucket utilizzando la console Google Cloud)resourcemanager.projects.get
(richiesto solo se si crea un bucket utilizzando la console Google Cloud)
Potresti essere in grado di ottenere queste autorizzazioni anche con i ruoli personalizzati o altri ruoli predefiniti. Per sapere quali ruoli sono associati a quali autorizzazioni, consulta Ruoli IAM per Cloud Storage.
Per istruzioni sulla concessione dei ruoli per i progetti, consulta Gestire l'accesso ai progetti.
Creazione di un nuovo bucket
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
- Fai clic su + Crea.
- Nella pagina Crea un bucket, inserisci le informazioni del bucket. Per andare al passaggio successivo, fai clic su Continua.
- In Assegna un nome al bucket, inserisci un nome che soddisfi i requisiti per i nomi dei bucket.
- Per Scegli dove archiviare i tuoi dati, seleziona un tipo di località e una località in cui verranno archiviati definitivamente i dati del bucket.
- In Scegli una classe di archiviazione per i tuoi dati, seleziona una classe di archiviazione predefinita per il bucket oppure Autoclass per la gestione automatica della classe di archiviazione dei dati del bucket.
Nota:il riquadro Stima del costo mensile nel riquadro di destra stima i costi mensili del bucket in base alla classe di archiviazione e alla località selezionate, nonché alle dimensioni e alle operazioni previste per i dati.
- Per Scegli come controllare l'accesso agli oggetti, scegli se il bucket deve applicare o meno la prevenzione dell'accesso pubblico e seleziona un modello di controllo dell'accesso per gli oggetti del bucket.
Nota: se la prevenzione dell'accesso pubblico è già applicata dal criterio dell'organizzazione del progetto, l'opzione di attivazione/disattivazione Impedisci l'accesso pubblico è bloccata.
- Per Scegli come proteggere i dati degli oggetti, se vuoi configura Strumenti di protezione e seleziona un metodo di crittografia dei dati.
- Fai clic su Crea.
Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Google Cloud, consulta Risoluzione dei problemi.
Riga di comando
-
Nella console Google Cloud, attiva Cloud Shell.
Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.
-
Nel tuo ambiente di sviluppo, esegui il comando
gcloud storage buckets create
:gcloud storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION
Dove:
BUCKET_NAME
è il nome che vuoi assegnare al bucket, soggetto ai requisiti di denominazione. Ad esempio,my-bucket
.BUCKET_LOCATION
è la località del bucket. Ad esempio:us-east1
.
Se la richiesta ha esito positivo, il comando restituisce il seguente messaggio:
Creating gs://BUCKET_NAME/...
Imposta i flag seguenti per avere un maggiore controllo sulla creazione del bucket:
--project
: specifica l'ID o il numero del progetto a cui sarà associato il bucket. Ad esempio,my-project
.--default-storage-class
: specifica la classe di archiviazione predefinita del tuo bucket. Ad esempio:STANDARD
.--soft-delete-duration
: specifica la durata di conservazione per l'eliminazione temporanea del tuo bucket. Ad esempio:2w1d
.--uniform-bucket-level-access
: abilita l'accesso uniforme a livello di bucket per il bucket.
Per un elenco completo delle opzioni per la creazione dei bucket gcloud, vedi le opzioni di
buckets create
.Ad esempio:
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Terraform
Puoi utilizzare una risorsa Terraform per creare un bucket di archiviazione.
API REST
API JSON
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.- Crea un file JSON contenente le impostazioni per il bucket, che deve includere un valore
name
per il bucket. Consulta la documentazione relativa a Buckets:Insert per un elenco completo delle impostazioni. Di seguito sono riportate le impostazioni più comuni da includere: BUCKET_NAME
è il nome che vuoi assegnare al bucket, soggetto ai requisiti di denominazione. Ad esempio:my-bucket
.BUCKET_LOCATION
è la località in cui vuoi archiviare i dati degli oggetti del bucket. Ad esempio:US-EAST1
.STORAGE_CLASS
è la classe di archiviazione predefinita del tuo bucket. Ad esempio:STANDARD
.- Utilizza
cURL
per chiamare l'API JSON:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b?project=PROJECT_IDENTIFIER"
Dove:
JSON_FILE_NAME
è il nome del file JSON che hai creato nel passaggio 2.PROJECT_IDENTIFIER
è l'ID o il numero del progetto a cui sarà associato il tuo bucket. Ad esempio,my-project
.
{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
Dove:
API XML
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.- Crea un file XML contenente le impostazioni per il bucket. Consulta la documentazione XML: Create a bucket per un elenco completo delle impostazioni. Di seguito sono riportate le impostazioni più comuni da includere:
BUCKET_LOCATION
è la località in cui vuoi archiviare i dati degli oggetti del bucket. Ad esempio:US-EAST1
.STORAGE_CLASS
è la classe di archiviazione predefinita del tuo bucket. Ad esempio:STANDARD
.- Utilizza
cURL
per chiamare l'API XML:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.googleapis.com/BUCKET_NAME"
Dove:
XML_FILE_NAME
è il nome del file XML che hai creato nel passaggio 2.PROJECT_ID
è l'ID del progetto a cui verrà associato il bucket. Ad esempio,my-project
.BUCKET_NAME
è il nome che vuoi assegnare al bucket, soggetto ai requisiti di denominazione. Ad esempio:my-bucket
.
<CreateBucketConfiguration> <LocationConstraint>BUCKET_LOCATION</LocationConstraint> <StorageClass>STORAGE_CLASS</StorageClass> </CreateBucketConfiguration>
Dove:
Passaggi successivi
- Elenca i bucket di un progetto.
- Recuperare informazioni sui metadati di un bucket.
- Sposta o rinomina un bucket.
- Eliminare un bucket.
- Carica un oggetto nel bucket.
- Gestisci la creazione e la configurazione dei bucket con il connettore di configurazione Kubernetes.
Provalo
Se non conosci Google Cloud, crea un account per valutare le prestazioni di Cloud Storage in scenari reali. I nuovi clienti ricevono anche 300 $ di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
Prova Cloud Storage gratis