Questa pagina descrive come creare, elencare ed eliminare bucket con spazio dei nomi gerarchico abilitato.
Crea un bucket
Questa sezione descrive come creare un bucket con spazio dei nomi gerarchico in un bucket in cui è abilitato il controllo delle versioni.
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
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 a requisiti di denominazione. Ad esempio:my-bucket
.BUCKET_LOCATION
è la località del bucket. Ad esempio:us-east1
.--uniform-bucket-level-access
: abilita l'accesso uniforme a livello di bucket per il di sincronizzare la directory di una VM con un bucket.
--enable-hierarchical-namespace
: abilita lo spazio dei nomi gerarchico per lo di sincronizzare la directory di una VM con un 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 lo spazio di archiviazione predefinito del bucket. Ad esempio:STANDARD
.
Per un elenco completo delle opzioni per la creazione di bucket utilizzando Google Cloud CLI, consulta
buckets create
opzioni.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 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.
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: inserire la documentazione per 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
.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 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 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:
Il layout di archiviazione di un bucket descrive il modo in cui gli oggetti sono disposti all'interno di un bucket, in un o uno spazio dei nomi gerarchico. Per istruzioni sulla visualizzazione di un di archiviazione del bucket, consulta Ottenere il layout di archiviazione di un bucket.
Per elencare tutti i bucket, indipendentemente dal layout dello spazio di archiviazione, segui le istruzioni descritto in Bucket dell'elenco.
Puoi eliminare un bucket con uno spazio dei nomi gerarchico abilitato allo stesso modo degli altri bucket. Ai fini dell'eliminazione, se un bucket è abilitato con lo spazio dei nomi gerarchico contiene solo cartelle vuote e nessun oggetto o cartelle gestite, il bucket è considerato vuoto. Per istruzioni sull'eliminazione dei bucket, consulta la sezione 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