Scopri l'archiviazione di oggetti con Google Cloud CLI

Scopri l'archiviazione di oggetti con Google Cloud CLI

Questa pagina mostra come eseguire attività di base in Cloud Storage utilizzando Google Cloud CLI.

I costi sostenuti in Cloud Storage si basano sulle risorse che utilizzi. Questa guida rapida in genere utilizza risorse Cloud Storage per un valore inferiore a 0,01 $.

Prima di iniziare

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
Per inizializzare gcloud CLI, esegui questo comando:
gcloud init
Crea o seleziona un Google Cloud progetto.
Ruoli richiesti per selezionare o creare un progetto
• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.
Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.
• Creare un progetto Google Cloud :

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

• Seleziona il progetto Google Cloud che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del progetto Google Cloud .
Verifica che la fatturazione sia abilitata per il tuo progetto Google Cloud .
Concedi ruoli al tuo account utente. Esegui il seguente comando una volta per ciascuno dei seguenti ruoli IAM: roles/storage.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Sostituisci quanto segue:
• PROJECT_ID: il tuo ID progetto.
• USER_IDENTIFIER: l'identificatore del tuo account utente . Ad esempio: [e-mail].
• ROLE: il ruolo IAM che concedi al tuo account utente.

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Creare un progetto Google Cloud :

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

• Seleziona il progetto Google Cloud che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

Verifica che la fatturazione sia abilitata per il tuo progetto Google Cloud .

Concedi ruoli al tuo account utente. Esegui il seguente comando una volta per ciascuno dei seguenti ruoli IAM: roles/storage.admin

gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

Sostituisci quanto segue:

• PROJECT_ID: il tuo ID progetto.
• USER_IDENTIFIER: l'identificatore del tuo account utente . Ad esempio: [e-mail].
• ROLE: il ruolo IAM che concedi al tuo account utente.

Nota: se utilizzi Cloud Shell o un'istanza di Compute Engine, Google Cloud SDK è preinstallato e autenticato. Se la tua istanza Compute Engine è configurata senza un ambito delaccount di serviziot 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 globale per creare un bucket:

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

   Sostituisci BUCKET_NAME con un nome per il bucket.

   Attenzione: non includere informazioni sensibili nel nome del bucket, poiché lo spazio dei nomi dei bucket è globale e visibile pubblicamente.
   Vedi i requisiti per i nomi dei bucket.

   • I nomi dei bucket possono contenere solo lettere minuscole, caratteri numerici, trattini (-), trattini bassi (_) e punti (.). Gli spazi non sono consentiti. I nomi che contengono punti devono essere verificati.
   • 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 includono punti possono contenere fino a 222 caratteri, ma ogni singolo 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 puntata (ad esempio 192.168.5.4).
   • I nomi dei bucket non possono iniziare con il prefisso "goog".
   • I nomi dei bucket non devono contenere la parola "google" o parole simili che potrebbero sembrare errori di digitazione, ad esempio "g00gle".

   In caso di esito positivo, il comando restituisce una risposta simile alla seguente:

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

   Se il nome del bucket che hai scelto è già in uso, da parte tua o di qualcun altro, il comando restituisce una risposta come ServiceException: 409 Bucket my-awesome-bucket already exists. Riprova con un altro nome del bucket.

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

carica un oggetto nel bucket

1. Salva la seguente immagine sul tuo computer, ad esempio sul desktop.

   

   Nota: se utilizzi Cloud Shell o un'istanza Compute Engine, scarica l'immagine utilizzando il seguente comando: wget https://docs.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://BUCKET_NAME

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

   In caso di esito positivo, il comando restituisce una risposta simile alla seguente:

   Copying file://Desktop/kitten.png to gs://my-awesome-bucket/kitten.png
     Completed files 1/1 | 8.6kiB/8.6kiB

   L'oggetto è stato archiviato nel bucket.

Scarica l'oggetto dal bucket

1. Utilizza il comando gcloud storage cp per scaricare l'immagine archiviata nel bucket in una posizione del computer, ad esempio sul desktop:

   gcloud storage cp gs://BUCKET_NAME/kitten.png Desktop/kitten2.png

   In caso di esito positivo, il comando restituisce una risposta simile alla seguente:

   Copying gs://my-awesome-bucket/kitten.png to file://Desktop/kitten2.png
     Completed files 1/1 | 8.6kiB/8.6kiB 

   Hai appena scaricato qualcosa dal tuo bucket.

Copia l'oggetto in una cartella simulata del bucket

1. Utilizza il comando gcloud storage cp per creare una cartella simulata e copiarvi l'immagine:

   gcloud storage cp gs://BUCKET_NAME/kitten.png gs://BUCKET_NAME/quickstart-folder/kitten3.png

   Nota: le cartelle simulate di Cloud Storage presentano limitazioni rispetto ai file system locali o alle cartelle nei bucket con spazio dei nomi gerarchico abilitato, ma supportano molte delle stesse operazioni.

   In caso di esito positivo, il comando restituisce una risposta simile alla seguente:

   Copying gs://my-awesome-bucket/kitten.png to gs://my-awesome-bucket/quickstart-folder/kitten3.png
     Completed files 1/1 | 8.6kiB/8.6kiB 

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

elenca i contenuti di un bucket

1. Utilizza il comando gcloud storage ls per elencare i contenuti al livello più alto del bucket:

   gcloud storage ls gs://BUCKET_NAME

   In caso di esito positivo, il comando restituisce una risposta simile alla seguente:

   gs://my-awesome-bucket/kitten.png
   gs://my-awesome-bucket/quickstart-folder/

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

elenca i dettagli relativi a un oggetto

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

   gcloud storage ls gs://BUCKET_NAME/kitten.png --long

   In caso di esito positivo, il comando restituisce una risposta simile alla seguente:

   8775  2026-01-21T01:22:17Z  gs://srs-bucketcli/kitten.png
   TOTAL: 1 objects, 8775 bytes (8.57kiB)

   Hai appena ricevuto informazioni sulle dimensioni dell'immagine e sulla data di creazione.

Rendi gli oggetti pubblicamente accessibili

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

   gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME --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ò ottenere le tue immagini.

2. Per rimuovere questo accesso, utilizza il comando seguente:

   gcloud storage buckets remove-iam-policy-binding gs://BUCKET_NAME --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.

Nota: dopo aver rimosso l'accesso pubblico, potresti ancora essere in grado di accedere a una versione memorizzata nella cache delle tue immagini per un determinato periodo di tempo.

Concedi a qualcuno l'accesso al tuo bucket

1. Utilizza il comando gcloud storage buckets add-iam-policy-binding per concedere a un indirizzo email specifico l'autorizzazione per aggiungere oggetti al tuo bucket:

   gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME --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 questo utente può aggiungere elementi al tuo bucket.

2. Per rimuovere questa autorizzazione, utilizza il comando seguente:

   gcloud storage buckets remove-iam-policy-binding gs://BUCKET_NAME --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://BUCKET_NAME/kitten.png

   In caso di esito positivo, il comando restituisce una risposta simile alla seguente:

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

   Questa copia dell'immagine non è più archiviata su Cloud Storage (anche se la copia che hai creato nella cartella simulata quickstart-folder/ esiste ancora).

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, elimina il progetto Google Cloud con le risorse.

1. Utilizza il comando gcloud storage rm con il flag --recursive per eliminare il bucket e tutto ciò che contiene al suo interno:

   gcloud storage rm gs://BUCKET_NAME --recursive

   In caso di esito positivo, il comando restituisce una risposta simile alla seguente:

   Removing objects:
   Removing gs://my-awesome-bucket/quickstart-folder/kitten3.png#1768960201129254
     Completed 1/1
   Removing buckets:
   Removing gs://my-awesome-bucket/...
     Completed 1/1

   Il tuo bucket e i relativi contenuti sono stati eliminati.

Passaggi successivi

• Esplora la guida rapida di Cloud Storage con la Google Cloud console.
• Leggi la panoramica del prodotto Cloud Storage.
• Scopri di più sui prezzi di Cloud Storage.
• Consulta le pagine di riferimento per i comandi gcloud CLI. Ad esempio:
  • Creare bucket (buckets create)
  • Caricare, scaricare e copiare oggetti (cp)
  • Elenca bucket e oggetti (ls)
  • Aggiungere l'accesso ai bucket (buckets add-iam-policy-binding)
  • Elimina oggetti e bucket (rm)