In questa pagina viene descritto come creare, elencare ed eliminare i bucket in cui è abilitato lo spazio dei nomi gerarchico.
Crea un bucket
Questa sezione descrive come creare un bucket con uno spazio dei nomi gerarchico abilitato.
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 il comando
gcloud alpha storage buckets create
:gcloud alpha storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION --uniform-bucket-level-access --enable-hierarchical-namespace
Dove:
BUCKET_NAME
è il nome che vuoi assegnare al bucket, soggetto ai requisiti di denominazione. Ad esempio,my-bucket
.BUCKET_LOCATION
è la località del tuo bucket. Ad esempio:us-east1
.--uniform-bucket-level-access
: abilita l'accesso uniforme a livello di bucket per il bucket.
--enable-hierarchical-namespace
: abilita lo spazio dei nomi gerarchico per il bucket. Non puoi abilitare lo spazio dei nomi gerarchico in un bucket esistente.
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 sarà associato il bucket. Ad esempio,my-project
.--default-storage-class
: specifica la classe di archiviazione predefinita del tuo bucket. Ad esempio:STANDARD
.
Per un elenco completo delle opzioni per la creazione di bucket utilizzando Google Cloud CLI, consulta le opzioni di
buckets create
.Ad esempio:
gcloud alpha 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 la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Installa e inizializzatogcloud CLI per 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
name
per il bucket. Per un elenco completo delle impostazioni, consulta la documentazione Buckets:Insert. 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
è la classe di archiviazione predefinita del tuo bucket. Ad esempio:STANDARD
.hierarchicalNamespace.enabled
è impostato suTRUE
per abilitare lo spazio dei nomi gerarchico per il tuo bucket. Non puoi abilitare lo spazio dei nomi gerarchico in un bucket esistente.- 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 contiene le impostazioni del bucket.PROJECT_IDENTIFIER
è l'ID o il numero del progetto a cui sarà associato il bucket. Ad esempio,my-project
.
{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "hierarchicalNamespace": { "enabled": "BOOLEAN" }, }
Dove:
Elenca un bucket
L'elenco dei bucket con spazio dei nomi gerarchico abilitato utilizza la stessa procedura utilizzata per elencare un bucket senza uno spazio dei nomi gerarchico abilitato. Per istruzioni sull'elenco dei bucket, consulta la sezione Bucket dell'elenco.
Elimina un bucket
Puoi eliminare un bucket se contiene solo cartelle vuote e nessun oggetto o cartelle gestite.
Il processo per l'eliminazione dei bucket con spazio dei nomi gerarchico abilitato è uguale all'eliminazione dei bucket senza spazio dei nomi gerarchico abilitato. Per istruzioni sull'eliminazione dei bucket, consulta Eliminare i bucket.
Passaggi successivi
- Ottenere informazioni sui metadati di un bucket
- Ottenere informazioni sul layout di archiviazione di un bucket
- Informazioni sulle cartelle.
- Creare e gestire cartelle.
- Rinominare le cartelle.
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