Questa pagina mostra come creare un bucket Cloud Storage. Se non diversamente specificato nella richiesta, i bucket vengono creati con una classe di archiviazione predefinita di archiviazione standard e hanno una durata di conservazione dell'eliminazione temporanea di sette giorni.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per creare 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 vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.create
storage.buckets.enableObjectRetention
(obbligatorio solo se si attivano le configurazioni della conservazione degli oggetti per il bucket)storage.buckets.list
(obbligatorio solo se crei un bucket utilizzando la console Trusted Cloud ).resourcemanager.projects.get
(obbligatorio solo se crei un bucket utilizzando la console Trusted Cloud )
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti. Per vedere quali ruoli sono associati a quali autorizzazioni, consulta la pagina Ruoli IAM per Cloud Storage.
Per istruzioni sulla concessione dei ruoli per i progetti, vedi Gestire l'accesso ai progetti.
Creazione di un nuovo bucket
Se crei un bucket per la prima volta, consulta Scopri l'archiviazione di oggetti con la console Trusted Cloud o Scopri l'archiviazione di oggetti con lo strumento Google Cloud CLI.
Per creare un bucket con impostazioni specifiche o configurazioni avanzate, completa i seguenti passaggi:
Console
- Nella console Trusted Cloud , vai alla pagina Bucket in Cloud Storage.
Fai clic su
Crea.Nella pagina Crea un bucket, inserisci le informazioni del bucket. Dopo ogni passaggio seguente, fai clic su Continua per procedere con il passaggio successivo:
Nella sezione Inizia, segui questi passaggi:
Inserisci un nome univoco globale che soddisfi i requisiti per i nomi dei bucket.
Per aggiungere un'etichetta bucket, fai clic sulla freccia di espansione per espandere la sezione Etichette, fai clic su add_box Aggiungi etichetta e specifica un
key
e unvalue
per l'etichetta.
Nella sezione Scegli dove archiviare i tuoi dati, segui questi passaggi:
Seleziona un Tipo di località.
Utilizza il menu a discesa del tipo di località per selezionare una località in cui i dati degli oggetti all'interno del bucket verranno archiviati in modo permanente.
- Se selezioni il tipo di località a doppia regione, puoi anche scegliere di attivare la replica turbo utilizzando la casella di controllo pertinente.
Nella sezione Scegli come archiviare i tuoi dati, segui questi passaggi:
- Seleziona una classe di archiviazione predefinita per il bucket o Autoclass per la gestione automatica della classe di archiviazione dei dati del bucket.
Nella sezione Ottimizza l'archiviazione per workload con uso intensivo dei dati, segui questi passaggi:
Per abilitare lo spazio dei nomi gerarchico, seleziona Abilita uno spazio dei nomi gerarchico in questo bucket.
Per attivare Anywhere Cache, seleziona Abilita Anywhere Cache.
Per creare le cache, fai clic su Configura.
Nella finestra di dialogo Configura impostazioni cache visualizzata, fai clic sulla freccia menu a discesa accanto alle regioni elencate e seleziona le zone in cui vuoi creare le cache.
Fai clic su Fine.
Fai clic su Continua.
Nella sezione Scegli come controllare l'accesso agli oggetti, seleziona se il bucket applica o meno la prevenzione dell'accesso pubblico e seleziona un modello di controllo dell'accesso per gli oggetti del bucket.
Nella sezione Scegli come proteggere i dati degli oggetti, segui questi passaggi:
Seleziona una delle opzioni in Protezione dei dati che vuoi impostare per il bucket.
Per attivare l'eliminazione temporanea, fai clic sulla freccia di espansione etichettata Policy di eliminazione temporanea e specifica il numero di giorni per cui vuoi conservare gli oggetti dopo l'eliminazione.
Per scegliere come criptare i dati degli oggetti, fai clic sulla freccia di espansione metodo di crittografia dei dati.
con l'etichetta Crittografia dei dati e seleziona un
Fai clic su Crea.
Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Trusted Cloud , consulta Risoluzione dei problemi.
Riga di comando
-
In the Trusted Cloud console, activate Cloud Shell.
At the bottom of the Trusted Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Nell'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 dare al bucket, soggetto ai requisiti di denominazione. Ad esempiomy-bucket
.BUCKET_LOCATION
è la posizione del tuo bucket. Ad esempio:U-FRANCE-EAST1
.
Se la richiesta riesce, il comando restituisce il seguente messaggio:
Creating gs://BUCKET_NAME/...
Imposta i seguenti flag per avere un maggiore controllo sulla creazione del bucket:
--project
: specifica l'ID progetto o il numero di progetto a cui verrà associato il bucket. Ad esempio,my-project
.--default-storage-class
: specifica la classe di archiviazione predefinita del bucket. Ad esempio:STANDARD
.--uniform-bucket-level-access
: attiva l'accesso uniforme a livello di bucket per il tuo bucket.--soft-delete-duration
: specifica una durata di conservazione dell'eliminazione temporanea, ovvero il numero di giorni per cui vuoi conservare gli oggetti dopo l'eliminazione. Ad esempio:10d
.
Ad esempio:
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access --soft-delete-duration=RETENTION_DURATION
Per un elenco completo delle opzioni per la creazione di bucket, utilizza gcloud CLI. Consulta le opzioni di
buckets create
.Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione
Authorization
.Crea un file JSON contenente le impostazioni del bucket, che deve includere un
name
per il bucket. Consulta la documentazione Buckets:Insert per un elenco completo delle impostazioni. Di seguito sono riportate le impostazioni comuni da includere:{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
Dove:
BUCKET_NAME
è il nome che vuoi dare al bucket, soggetto ai requisiti di denominazione. Ad esempiomy-bucket
.BUCKET_LOCATION
è la posizione in cui vuoi archiviare i dati degli oggetti del bucket. Ad esempioU-FRANCE-EAST1
.STORAGE_CLASS
è la classe di archiviazione predefinita del 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.s3nsapis.fr/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 verrà associato il bucket. Ad esempio,my-project
.
Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione
Authorization
.Crea un file XML che contenga le impostazioni per il bucket. Consulta la documentazione XML: Create a bucket per un elenco completo delle impostazioni. Di seguito sono riportate le impostazioni comuni da includere:
<CreateBucketConfiguration> <StorageClass>STORAGE_CLASS</StorageClass> <LocationConstraint>BUCKET_LOCATION</LocationConstraint> </CreateBucketConfiguration>
Dove:
STORAGE_CLASS
è la classe di archiviazione predefinita del bucket. Ad esempio:STANDARD
.BUCKET_LOCATION
è la posizione in cui vuoi archiviare i dati degli oggetti del bucket. Ad esempioU-FRANCE-EAST1
.
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.s3nsapis.fr/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 dare al bucket, soggetto ai requisiti di denominazione. Ad esempiomy-bucket
.
Se la richiesta è andata a buon fine, non viene restituita alcuna risposta.
Librerie client
C++
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
C#
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
Go
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
Node.js
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
PHP
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
Python
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
Ruby
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
Terraform
Puoi utilizzare una risorsa Terraform per creare un bucket di archiviazione.
API REST
API JSON
API XML
Passaggi successivi
- Elenca i bucket in un progetto.
- Scopri di più sui metadati associati a un bucket.
- Spostare o rinominare un bucket.
- Eliminare un bucket.
- Carica un oggetto nel bucket.
- Crea e configura i bucket in modo dichiarativo con Kubernetes Config Connector, che ti consente di descrivere Trusted Cloud by S3NS le risorse utilizzando gli strumenti, le API e le configurazioni di Kubernetes. Per ulteriori informazioni, consulta la documentazione dell'API Config Connector.