In diesem Dokument wird beschrieben, wie Daten mithilfe der Cloud Storage-Clientbibliothek gespeichert und abgerufen werden. Es wird davon ausgegangen, dass Sie die unter Cloud Storage einrichten beschriebenen Aufgaben durchgeführt und somit einen Cloud Storage-Bucket aktiviert sowie die Clientbibliotheken heruntergeladen haben. Außerdem sollten Sie eine App Engine-Anwendung erstellen können.
Weitere Codebeispiele finden Sie unter Cloud Storage-Clientbibliotheken.
Erforderliche Importe
Für App Engine und Cloud Storage sind folgende Importe in der Datei erforderlich:
google.golang.org/appengine
,google.golang.org/appengine/file
cloud.google.com/go/storage
Siehe folgender Snippet:
Cloud Storage-Bucket angeben
Bevor Sie einen Cloud Storage-Vorgang ausführen können, müssen Sie den Bucket-Namen angeben. Am einfachsten ist es, wenn Sie dafür den Standard-Bucket Ihres Projekts verwenden. Dieser kann wie im folgenden Snippet aus dem App Engine-Kontext abgerufen werden:
Schreibvorgänge in Cloud Storage
So schreiben Sie eine Datei in Cloud Storage:
Beim Erstellen der Datei werden im Beispiel Cloud Storage-Header festgelegt (x-goog-meta-foo
und x-goog-meta-bar
). Dieser optionale Code zeigt die Verwendung von Cloud Storage-Headern, die Sie nutzen können, um
- das Verhalten von Anfragen zu beeinflussen,
- den Zugriff auf die Datei im Bucket anzugeben, der sich von den Standardeinstellungen unterscheidet (siehe x-goog-acl), und
- Dateimetadaten zu schreiben.
Die oben gezeigten x-goog-meta-*
-Header sind benutzerdefinierte Dateimetadaten, die Sie festlegen können. Diese Header werden immer mit der Datei zurückgegeben. Der verfügbare Speicherplatz für benutzerdefinierte Header und ihre Daten ist auf wenige Kilobyte beschränkt. Sie sollten sie also mit Bedacht einsetzen.
Da x-goog-acl
im Codebeispiel nicht festgelegt wird, wird die standardmäßige Cloud Storage-ACL des öffentlichen Lesezugriffs auf das Objekt angewendet, wenn es in den Bucket geschrieben wird.
Achten Sie außerdem auf den Aufruf von Close()
für die Datei, nachdem der Schreibvorgang abgeschlossen ist. Ohne diesen Aufruf wird die Datei nicht in Cloud Storage geschrieben. Nach dem Aufrufen von Close()
ist das Anhängen an die Datei nicht möglich.
Lesevorgänge in Cloud Storage
So lesen Sie eine Datei aus Cloud Storage:Bucket-Inhalt auflisten
Dieser Beispielcode zeigt, wie Sie die Inhalte des Buckets auflisten:
Dateien in Cloud Storage löschen
Anhand des folgenden Codes wird veranschaulicht, wie Sie mit der Methode ObjectHandle.delete()
eine Datei aus Cloud Storage löschen können.
In diesem Beispiel werden die Dateien bereinigt, die im Abschnitt Schreibvorgänge in Cloud Storage in den Bucket geschrieben wurden.
Nächste Schritte
- API-Referenzdokumentation
- Weitere Leitfäden und Anleitungen finden Sie in der Cloud Storage-Dokumentation.