Scopri l'archiviazione di oggetti con lo strumento gcloud

Scopri l'archiviazione di oggetti con lo strumento gcloud

Questa pagina mostra come eseguire attività di base in Cloud Storage utilizzando lo strumento a riga di comando gcloud.

I costi sostenuti in Cloud Storage si basano sulle risorse che utilizzi. Questa guida rapida in genere utilizza meno di 0,01 $di alle risorse di Cloud Storage.

Prima di iniziare

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, click Create project to begin creating a new Google Cloud project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Install the Google Cloud CLI.

5. To initialize the gcloud CLI, run the following command:

   gcloud init

6. In the Google Cloud console, on the project selector page, click Create project to begin creating a new Google Cloud project.

   Go to project selector

7. Make sure that billing is enabled for your Google Cloud project.

8. Install the Google Cloud CLI.

9. To initialize the gcloud CLI, run the following command:

   gcloud init

Nota: se utilizzi Cloud Shell o un'istanza Compute Engine, Google Cloud SDK è preinstallato e autenticato. Se i tuoi Compute Engine sia configurata senza un ambito dell'account di servizio per Cloud Storage, esegui gcloud init e segui le istruzioni.

Crea un bucket

I bucket sono i container di base di Cloud Storage in cui vengono archiviati i dati.

Per creare un bucket:

1. Apri una finestra del terminale.

2. Utilizza il comando gcloud storage buckets create e un nome univoco per crea un bucket:

   gcloud storage buckets create gs://my-awesome-bucket/ --uniform-bucket-level-access

   Viene utilizzato un bucket denominato "my-awesome-bucket". Devi scegliere i tuoi, un nome bucket univoco a livello globale.

   Vedi i requisiti di denominazione dei bucket.

   • I nomi dei bucket possono contenere solo lettere minuscole, caratteri numerici, trattini (-) trattini bassi (_) e punti (.). Gli spazi non sono consentiti. Per i nomi che contengono punti è necessaria la verifica.
   • I nomi dei bucket devono iniziare e terminare con un numero o con una lettera.
   • I nomi dei bucket devono contenere da 3 a 63 caratteri. I nomi che contengono punti possono contenere fino a 222 caratteri, ma ogni componente separato da un punto non può essere più lungo di 63 caratteri.
   • I nomi dei bucket non possono essere rappresentati da un indirizzo IP con notazione decimale separata da punti (ad esempio, 192.168.5.4).
   • I nomi dei bucket non possono iniziare con il prefisso "goog".
   • I nomi dei bucket non possono contenere "google" o errori ortografici più comuni, come "g00gle".

   di Gemini Advanced.
   .
   Attenzione: non includere informazioni sensibili nel nome del bucket, in quanto lo spazio dei nomi dei bucket è globale e visibile pubblicamente.

   In caso di esito positivo, il comando restituisce:

   Creating gs://my-awesome-bucket/...

Il bucket per l'archiviazione dei tuoi dati è stato creato.

Nota: se il nome del bucket che hai scelto è già in uso, da te o da qualcuno altrimenti il comando restituisce:

Creating gs://my-awesome-bucket/...
ServiceException: 409 Bucket my-awesome-bucket already exists.

Riprova utilizzando un altro nome per il bucket.

carica un oggetto nel bucket

1. Fai clic con il pulsante destro del mouse sull'immagine riportata sopra e salvala sul computer ad esempio su computer.

   Nota: se utilizzi Cloud Shell o un'istanza Compute Engine, scarica l'immagine utilizzando questo comando: wget https://cloud.google.com/storage/images/kitten.png

2. Utilizza il comando gcloud storage cp per copiare l'immagine dalla posizione in cui l'hai salvata nel bucket che hai creato:

   gcloud storage cp Desktop/kitten.png gs://my-awesome-bucket

   In caso di esito positivo, il comando restituisce:

   Copying file://Desktop/kitten.png [Content-Type=image/png]...
   Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
   Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

   L'oggetto è stato archiviato nel bucket.

di Gemini Advanced.

Nota: quando digiti il nome del bucket, puoi utilizzare il tasto Tab per completarlo automaticamente.

Scarica l'oggetto dal bucket

1. Usa il comando gcloud storage cp per scaricare l'immagine che hai archiviato nel bucket in una posizione sul computer, ad esempio sul desktop:

   gcloud storage cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

   In caso di esito positivo, il comando restituisce:

   Copying gs://my-awesome-bucket/kitten.png...
   Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
   Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

   Hai appena scaricato qualcosa dal tuo bucket.

Copia l'oggetto in una cartella del bucket

1. Utilizza il comando gcloud storage cp per creare una cartella e copiare al suo interno:

   gcloud storage cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png

   Nota: le cartelle di Cloud Storage hanno limitazioni rispetto alle applicazioni locali ma sono supportate molte delle stesse operazioni.

   In caso di esito positivo, il comando restituisce:

   Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
   Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB

   Hai appena copiato l'immagine in una nuova cartella nel tuo bucket.

elenca i contenuti di un bucket o di una cartella

1. Usa il comando gcloud storage ls per elencare i contenuti nella parte superiore livello del bucket:

   gcloud storage ls gs://my-awesome-bucket

   Se l'esito è positivo, il comando restituisce un messaggio simile al seguente:

   gs://my-awesome-bucket/kitten.png
   gs://my-awesome-bucket/just-a-folder/

   Hai appena visto i contenuti al livello più alto del tuo bucket.

elenca i dettagli relativi a un oggetto

1. Usa il comando gcloud storage ls, con il flag --long per ottenere qualche dettagli su una delle tue immagini:

   gcloud storage ls gs://my-awesome-bucket/kitten.png --long

   Se l'esito è positivo, il comando restituisce un messaggio simile al seguente:

   2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
   TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)

   Hai appena ottenuto informazioni sulle dimensioni e sulla data dell'immagine per la creazione di contenuti.

Rendi gli oggetti pubblicamente accessibili

1. Utilizza il comando gcloud storage buckets add-iam-policy-binding per concedere tutte l'autorizzazione degli utenti a leggere le immagini archiviate nel tuo bucket:

   gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer

   Il comando ha esito positivo se la risposta contiene quanto segue:

   bindings:
     - members:
       - allUsers
       role: roles/storage.objectViewer
   

   Ora chiunque può recuperare le tue immagini.

2. Per rimuovere questo accesso, utilizza il comando:

   gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer

   Il comando ha esito positivo se non viene restituito alcun errore.

   Hai rimosso l'accesso pubblico alle immagini nel tuo bucket.

di Gemini Advanced.

Nota: dopo aver rimosso l'accesso pubblico, potresti comunque riuscire ad accedere a una copia cache di una delle tue immagini per un determinato periodo di tempo.

Concedi a qualcuno l'accesso al tuo bucket

1. Usa il comando gcloud storage buckets add-iam-policy-binding per assegnare l'autorizzazione di un indirizzo email specifico per aggiungere oggetti al bucket:

   gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=user:[e-mail] --role=roles/storage.objectCreator

   Il comando ha esito positivo se la risposta contiene quanto segue:

   bindings:
     - members:
       - user:[e-mail]
       role: roles/storage.objectCreator
   

   Ora qualcun altro può aggiungere elementi al tuo bucket.

2. Per rimuovere questa autorizzazione, utilizza il comando:

   gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=user:[e-mail] --role=roles/storage.objectCreator

   Il comando ha esito positivo se non viene restituito alcun errore.

   Hai rimosso l'accesso dell'utente a questo bucket.

Elimina un oggetto

1. Usa il comando gcloud storage rm per eliminare una delle tue immagini:

   gcloud storage rm gs://my-awesome-bucket/kitten.png

   In caso di esito positivo, il comando restituisce:

   Removing gs://my-awesome-bucket/kitten.png...

   Questa copia dell'immagine non è più archiviata su Cloud Storage (sebbene la copia che hai creato nella cartella just-a-folder/ esista ancora).

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi per le risorse utilizzate in questa pagina, segui questi passaggi.

1. Apri una finestra del terminale (se non è già aperta).

2. Usa il comando gcloud storage rm con il flag --recursive per elimina il bucket e qualsiasi cosa al suo interno:

   gcloud storage rm gs://my-awesome-bucket --recursive

   Se l'esito è positivo, il comando restituisce un messaggio simile al seguente:

   Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
   Removing gs://my-awesome-bucket/...

   Il tuo bucket e i relativi contenuti sono stati eliminati.

Passaggi successivi

• Esplora la guida rapida di Cloud Storage con la console Google Cloud.
• Leggi la panoramica del prodotto Cloud Storage.

• Scopri di più sui prezzi di Cloud Storage.

• Consulta le pagine di riferimento per i comandi di Google Cloud CLI, come crea bucket (buckets create), copy (cp), elenco (ls), aggiungi l'accesso (buckets add-iam-policy-binding e rimuovi (rm).