Questa pagina mostra come creare bucket di 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 la creazione di un file di Cloud Storage
chiedi all'amministratore di concederti il ruolo Amministratore Storage
(roles/storage.admin
) Ruolo IAM per il progetto.
Questo ruolo predefinito contiene l'autorizzazione necessaria 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 riuscire a ottenere queste autorizzazioni con i 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
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
- Fai clic su + Crea.
- Nella pagina Crea un bucket, inserisci le informazioni sul bucket. Per accedere alla sezione
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'opzione Tipo di località e Località in cui i dati del bucket verranno archiviati in modo permanente.
- Per Scegli una classe di archiviazione per i tuoi dati, seleziona un'opzione
predefinita di archiviazione per il bucket, oppure seleziona
Autoclass per la gestione automatica delle classi di archiviazione
del bucket.
Nota:il riquadro Stima del costo mensile nella nel riquadro a destra stima i costi mensili del bucket in base alla classe di archiviazione selezionata località, nonché la dimensione dei dati e le operazioni previste.
- Per Scegli come controllare l'accesso agli oggetti, scegli se il tuo bucket
applica la prevenzione dell'accesso pubblico e
seleziona un modello di controllo dell'accesso per
del bucket.
Nota: se la prevenzione dell'accesso pubblico è già applicata in modo forzato dal criteri dell'organizzazione, l'opzione Impedisci accesso pubblico sia bloccata.
- Per Scegli come proteggere i dati degli oggetti, configura Strumenti di protezione se vuoi, e seleziona un metodo di Crittografia dei dati.
- Fai clic su Crea.
Scopri come ottenere informazioni dettagliate sugli errori relativi a Cloud Storage non riusciti nella console Google Cloud, vedi 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.
-
Nell'ambiente di sviluppo, esegui
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 a 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 seguenti flag per avere un maggiore controllo sulla creazione del bucket:
--project
: specifica l'ID o il numero di progetto a cui verrà associato il bucket. Ad esempio,my-project
.--default-storage-class
: specifica lo spazio di archiviazione predefinito del bucket. Ad esempio:STANDARD
.--soft-delete-duration
: specifica la durata di conservazione dell'eliminazione temporanea del bucket. Ad esempio:2w1d
.--uniform-bucket-level-access
: abilita l'accesso uniforme a livello di bucket per il tuo bucket.
Per un elenco completo delle opzioni per la creazione di bucket con gcloud, consulta
buckets create
opzioni.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 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, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
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, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta API Cloud Storage Go 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.
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, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta API Cloud Storage Node.js 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.
PHP
Per ulteriori informazioni, consulta API Cloud Storage PHP 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.
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 ulteriori informazioni, consulta API Cloud Storage Ruby 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.
Terraform
Puoi utilizzare una risorsa Terraform per creare un bucket di archiviazione.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.- Crea un file JSON contenente le impostazioni per il bucket, che deve includere un
name
per il bucket. Consulta le Bucket:Insert per la documentazione di un l'elenco completo delle impostazioni. Di seguito sono riportate alcune impostazioni comuni da includere: BUCKET_NAME
è il nome che vuoi assegnare al bucket, in conformità ai requisiti di denominazione. Ad esempio:my-bucket
.BUCKET_LOCATION
è la località in cui vuoi archiviare i dati dell'oggetto del bucket. Ad esempio:US-EAST1
.STORAGE_CLASS
è lo spazio di archiviazione predefinito del bucket. Ad esempio:STANDARD
.- Utilizza
cURL
per chiamare il metodo 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
.
{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
Dove:
API XML
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.- Crea un file XML che contenga le impostazioni del bucket. Consulta le XML: creazione di un bucket per un l'elenco completo delle impostazioni. Di seguito sono riportate alcune impostazioni comuni da includere:
BUCKET_LOCATION
è la località in cui vuoi archiviare i dati dell'oggetto del bucket. Ad esempio:US-EAST1
.STORAGE_CLASS
è lo spazio di archiviazione predefinito del bucket. Ad esempio:STANDARD
.- Utilizza
cURL
per chiamare il metodo 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 a requisiti di denominazione. Ad esempio:my-bucket
.
<CreateBucketConfiguration> <LocationConstraint>BUCKET_LOCATION</LocationConstraint> <StorageClass>STORAGE_CLASS</StorageClass> </CreateBucketConfiguration>
Dove:
Passaggi successivi
- Elenca i bucket in un progetto.
- Recuperare informazioni sui metadati di un bucket.
- Ottenere informazioni sul layout di archiviazione 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 Kubernetes 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