Questo documento descrive come archiviare e recuperare i dati utilizzando la libreria client Cloud Storage. Presuppone che tu abbia completato le attività descritte in Configurazione per Cloud Storage per attivare un bucket Cloud Storage e scaricare le librerie client. Inoltre, presuppone che tu sappia come creare un'applicazione App Engine.
Per ulteriori esempi di codice, consulta Librerie client di Cloud Storage .
Importazioni richieste
Le importazioni nel file richieste per App Engine e per Cloud Storage sono:
google.golang.org/appengine
,google.golang.org/appengine/file
cloud.google.com/go/storage
come mostrato nello snippet seguente:
Specificare il bucket Cloud Storage
Prima di poter eseguire qualsiasi operazione Cloud Storage, devi fornire il nome del bucket. Il modo più semplice per farlo è utilizzare il bucket predefinito per il tuo progetto, che può essere ottenuto dal contesto App Engine, come mostrato in questo snippet:
Scrittura in Cloud Storage
Per scrivere un file in Cloud Storage:
Quando viene creato il file, l'esempio specifica le intestazioni Cloud Storage (x-goog-meta-foo
e x-goog-meta-bar
). Questo codice facoltativo introduce il concetto
di utilizzo delle intestazioni Cloud Storage, che puoi
applicare a:
- Influenzare il comportamento delle richieste
- Specifica l'accesso al file nel bucket diverso dai valori predefiniti (vedi x-goog-acl)
- Scrivi i metadati del file.
Le intestazioni x-goog-meta-*
mostrate
sopra sono metadati personalizzati dei file che puoi impostare; queste intestazioni vengono sempre
restituite con il file. Tieni presente che lo spazio disponibile per le intestazioni personalizzate e
i relativi dati è limitato a pochi kilobyte, quindi utilizzali con attenzione.
Poiché l'esempio di codice non imposta x-goog-acl
, l'ACL Cloud Storage predefinita di lettura pubblica viene applicata all'oggetto quando viene scritto nel bucket.
Infine, nota la chiamata a Close()
del file al termine della scrittura. Se
non lo fai, il file non viene scritto in Cloud Storage. Tieni presente
che dopo aver chiamato Close()
, non puoi aggiungere contenuti al file.
Lettura da Cloud Storage
Per leggere un file da Cloud Storage:Elenco dei contenuti del bucket
Questo codice campione mostra come elencare i contenuti del bucket:
Eliminazione di file in Cloud Storage
Il codice riportato di seguito mostra come eliminare un file da Cloud Storage utilizzando il metodo
ObjectHandle.delete()
.
Questo esempio pulisce i file scritti nel bucket nella sezione Scrittura in Cloud Storage.
Passaggi successivi
- Visita la documentazione di riferimento dell'API.
- Per altre guide e tutorial, consulta la documentazione di Cloud Storage.