Questa pagina mostra come creare bucket Cloud Storage. In caso contrario
altrimenti specificati nella richiesta, i bucket vengono creati
US
(più regioni) con una classe di archiviazione predefinita Standard Storage
con 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 archiviazione (roles/storage.admin
) per il progetto.
Questo ruolo predefinito contiene l'autorizzazione richiesta per creare un bucket. Per vedere con esattezza le autorizzazioni necessarie, espandi la sezione Sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.create
storage.buckets.enableObjectRetention
(richiesto solo se l'abilitazione delle configurazioni di conservazione degli oggetti per il bucket)storage.buckets.list
(richiesto solo se la creazione di un utilizzando la console Google Cloud)resourcemanager.projects.get
(richiesto solo se la creazione di un utilizzando la console Google Cloud)
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti. Per vedere quali ruoli sono associati a quali autorizzazioni, Consulta i ruoli IAM per Cloud Storage.
Per istruzioni su come concedere i ruoli per i progetti, consulta Gestire l'accesso ai progetti.
Creazione di un nuovo bucket
Se stai creando un bucket per la prima volta, consulta Scopri l'archiviazione di oggetti con la console Google Cloud o Scopri l'archiviazione di oggetti con strumento Google Cloud CLI.
Per creare bucket con impostazioni specifiche o configurazioni avanzate, completa segui questi passaggi:
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. Dopo il giorno in ciascuno dei passaggi successivi, fai clic su Continua per procedere con passaggio:
Nella sezione Inizia, segui questi passaggi:
- Inserisci un nome globalmente univoco che soddisfi i requisiti requisiti per i nomi dei bucket.
Per attivare lo spazio dei nomi gerarchico, fai clic sulla freccia di espansione per espandere la sezione Ottimizza per carichi di lavoro orientati ai file e con uso intensivo di dati e poi seleziona Attiva uno spazio dei nomi gerarchico in questo bucket.
Per aggiungere un'etichetta del 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 verranno archiviati definitivamente i dati degli oggetti all'interno del bucket.
- Se selezioni il tipo di località a due regioni, puoi anche scegliere di attivare la replica turbo utilizzando la casella di controllo pertinente.
Per configurare la replica tra bucket, espandi la Configura la replica tra bucket e segui questi passaggi:
Configura la replica tra bucket
- Seleziona la casella di controllo accanto ad Aggiungi una replica tra bucket mediante Storage Transfer Service.
- Nel menu Bucket di destinazione, seleziona un bucket di destinazione.
Nella sezione Impostazioni di replica, fai clic su Configura per configurare le impostazioni per il job di replica.
Viene visualizzato il riquadro Configura replica tra bucket.
- Per filtrare gli oggetti da replicare in base al prefisso del nome dell'oggetto, inserisci un prefisso con cui vuoi includere o escludere gli oggetti, quindi fai clic su Aggiungi un prefisso.
- Per impostare una classe di archiviazione per gli oggetti replicati, seleziona una classe di archiviazione dal menu Classe di archiviazione. Se salti questo passaggio, gli oggetti replicati utilizzeranno per impostazione predefinita la classe di archiviazione del bucket di destinazione.
- Fai clic su Fine.
Nella sezione Scegli una classe di archiviazione per i tuoi dati, 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 Scegli come controllare l'accesso agli oggetti, seleziona indipendentemente dal fatto che il bucket applichi 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, procedi nel seguente modo: seguenti:
In Protezione dei dati, seleziona una delle opzioni che vuoi da impostare per il bucket.
Per scegliere il modo in cui i dati dell'oggetto verranno criptati, fai clic sull'icona Freccia di espansione Metodo di crittografia dei dati.
con l'etichetta Crittografia dei dati e seleziona una
Fai clic su Crea.
Scopri come ottenere informazioni dettagliate sugli errori di Cloud Storage non riusciti nella console Google Cloud, vedi Risoluzione dei problemi.
Riga di comando
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google 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 Comando
gcloud storage buckets create
:gcloud storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION
Dove:
BUCKET_NAME
è il nome che vuoi assegnare al tuo bucket, soggetto al requisito di denominazione. Ad esempio,my-bucket
.BUCKET_LOCATION
è la posizione del tuo bucket. Ad esempio:us-east1
.
Se la richiesta ha esito positivo, il comando restituisce il seguente messaggio:
Creating gs://BUCKET_NAME/...
Imposta i seguenti flag per avere un maggiore controllo sulla creazione del tuo 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
: abilita l'accesso uniforme a livello di bucket per il tuo bucket.
Ad esempio:
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access
Per un elenco completo delle opzioni per la creazione di bucket, utilizza la gcloud CLI, consulta le opzioni
buckets create
.
Librerie client
C
Per ulteriori informazioni, consulta API Cloud Storage C documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C#
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per autenticarti a Cloud Storage, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per autenticarti a Cloud Storage, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta API Cloud Storage Java documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta API Cloud Storage Node.js documentazione di riferimento.
Per autenticarti a Cloud Storage, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta API Cloud Storage Python documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per autenticarti a Cloud Storage, configura le credenziali predefinite dell'applicazione. Per ulteriori 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
Avere installato e inizializzato l'interfaccia a riga di comando gcloud, che consente di generare un token di accesso per l'intestazione
Authorization
.Crea un file JSON contenente le impostazioni per il bucket, deve includere un
name
per il bucket. Consulta la documentazione di Buckets:Insert per un elenco completo delle impostazioni. Di seguito sono riportate le impostazioni comuni per includere:{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
Dove:
BUCKET_NAME
è il nome che vuoi assegnare del bucket, in base ai requisiti di denominazione. Ad esempio,my-bucket
.BUCKET_LOCATION
è la località in cui vuoi archiviare i dati dell'oggetto del tuo bucket. Ad esempio:US-EAST1
.STORAGE_CLASS
è l'impostazione predefinita classe di archiviazione 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 verrà associato il bucket. Ad esempio,my-project
.
API XML
Avere gcloud CLI installato e inizializzato, che consente generi un token di accesso per l'intestazione
Authorization
.Crea un file XML contenente le impostazioni per il bucket. Consulta la documentazione relativa a XML: crea un 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 sugli oggetti del bucket. Ad esempio,US-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.googleapis.com/BUCKET_NAME"
Dove:
XML_FILE_NAME
è il nome del file XML che 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 del bucket, in base ai requisiti di denominazione. Ad esempio,my-bucket
.
Se la richiesta ha esito positivo, non viene restituita una risposta.
Passaggi successivi
- Elenca i bucket in un progetto.
- Scopri di più sui metadati associati a un bucket.
- Sposta o rinomina 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 le risorse Google Cloud utilizzando gli strumenti, le API e le configurazioni di Kubernetes. Per ulteriori informazioni, consulta la documentazione dell'API Config Connector.
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 gratuitamente