Auf dieser Seite wird beschrieben, wie Sie Objekte aus Ihren Buckets in Cloud Storage in den nichtflüchtigen Speicher herunterladen. Sie können auch Objekte in den Arbeitsspeicher herunterladen.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die Rolle „Storage-Objekt-Betrachter“ (roles/storage.objectViewer
) für den Bucket zuzuweisen, um die erforderlichen Berechtigungen zum Herunterladen von Objekten zu erhalten. Wenn Sie die Google Cloud Console verwenden möchten, bitten Sie Ihren Administrator, Ihnen stattdessen die Rolle „Storage-Administrator“ (roles/storage.admin
) für den Bucket zuzuweisen.
Diese Rollen enthalten die Berechtigungen, die zum Herunterladen von Objekten erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
storage.buckets.list
- Diese Berechtigung ist nur erforderlich, um die Aufgaben auf dieser Seite mit der Google Cloud Console auszuführen.
storage.objects.get
storage.objects.list
- Diese Berechtigung ist nur erforderlich, um die Aufgaben auf dieser Seite mit der Google Cloud Console auszuführen.
Sie können diese Berechtigungen möglicherweise auch mit anderen vordefinierten Rollen oder benutzerdefinierten Rollen erhalten.
Eine Anleitung zum Zuweisen von Rollen für Buckets finden Sie unter IAM mit Buckets verwenden.
Objekt aus einem Bucket herunterladen
Führen Sie die folgenden Schritte aus, um ein Objekt aus einem Bucket herunterzuladen:
Console
- Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
Klicken Sie in der Liste der Buckets auf den Bucket, der das Objekt enthält, das Sie herunterladen möchten.
Die Seite Bucket-Details wird geöffnet und der Tab Objekte ist ausgewählt.
Wechseln Sie zu dem Objekt. Dieses befindet sich möglicherweise in einem Ordner.
Klicken Sie auf das Symbol Herunterladen, das dem Objekt zugeordnet ist.
In den Browsereinstellungen wird der Download-Speicherort für das Objekt gesteuert.
Unter Fehlerbehebung erfahren Sie, wie Sie detaillierte Fehlerinformationen zu fehlgeschlagenen Cloud Storage-Vorgängen in der Google Cloud Console abrufen.
Befehlszeile
Führen Sie folgenden gcloud storage cp
-Befehl aus:
gcloud storage cp gs://BUCKET_NAME/OBJECT_NAME SAVE_TO_LOCATION
Hierbei gilt:
BUCKET_NAME
ist der Name des Buckets mit dem Objekt, das Sie herunterladen. Beispiel:my-bucket
.OBJECT_NAME
ist der Name des Objekts, das Sie herunterladen. Beispiel:pets/dog.png
.SAVE_TO_LOCATION
ist der lokale Pfad, unter dem Sie Ihr Objekt speichern. Beispiel:Desktop/Images
.
Wenn der Vorgang erfolgreich war, sieht die Antwort so aus:
Completed files 1/1 | 164.3kiB/164.3kiB
Wenn der Download vor dem Abschluss unterbrochen wird, führen Sie den cp
-Befehl noch einmal aus, um den Download an der Stelle fortzusetzen, an der er unterbrochen wurde.
Clientbibliotheken
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird ein einzelnes Objekt heruntergeladen:
Im folgenden Beispiel werden mehrere Objekte mit mehreren Prozessen heruntergeladen:
Im folgenden Beispiel werden alle Objekte mit einem gemeinsamen Präfix mit mehreren Prozessen heruntergeladen:
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird ein einzelnes Objekt heruntergeladen:
Im folgenden Beispiel werden mehrere Objekte mit mehreren Prozessen heruntergeladen:
Im folgenden Beispiel werden alle Objekte mit einem gemeinsamen Präfix mit mehreren Prozessen heruntergeladen:
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird ein einzelnes Objekt heruntergeladen:
Im folgenden Beispiel werden mehrere Objekte mit mehreren Prozessen heruntergeladen:
Im folgenden Beispiel werden alle Objekte in einem Bucket mit mehreren Prozessen heruntergeladen:
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
REST APIs
JSON API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Verwenden Sie
cURL
, um die JSON API mit einerGET
-Objektanfrage aufzurufen:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Wobei:
SAVE_TO_LOCATION
ist der Pfad zu dem Speicherort, an dem Sie Ihr Objekt speichern möchten. Beispiel:Desktop/dog.png
BUCKET_NAME
ist der Name des Buckets mit dem Objekt, das Sie herunterladen. Beispiel:my-bucket
OBJECT_NAME
ist der URL-codierte Name des Objekts, das Sie herunterladen. Beispiel:pets/dog.png
, URL-codiert alspets%2Fdog.png
.
XML API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Verwenden Sie
cURL
, um die XML API mit einerGET
-Objektanfrage aufzurufen:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Wobei:
SAVE_TO_LOCATION
ist der Pfad zu dem Speicherort, an dem Sie Ihr Objekt speichern möchten. Beispiel:Desktop/dog.png
BUCKET_NAME
ist der Name des Buckets mit dem Objekt, das Sie herunterladen. Beispiel:my-bucket
OBJECT_NAME
ist der URL-codierte Name des Objekts, das Sie herunterladen. Beispiel:pets/dog.png
, URL-codiert alspets%2Fdog.png
.
Wenn Sie alle Objekte in einem Bucket oder Unterverzeichnis effizienter herunterladen möchten, verwenden Sie den Befehl gcloud storage cp
oder eine Clientbibliothek.
Teil eines Objekts herunterladen
Wenn der Download unterbrochen wird, können Sie an der Stelle fortfahren, an der Sie aufgehört haben. Fordern Sie dazu nur den verbleibenden Teil des Objekts an. Führen Sie die folgenden Schritte aus, um einen Teil eines Objekts herunterzuladen.
Console
Die Google Cloud Console unterstützt nicht das Herunterladen von Teilen eines Objekts. Verwenden Sie stattdessen die gcloud CLI.
Befehlszeile
Die Google Cloud CLI versucht automatisch, unterbrochene Downloads fortzusetzen, außer bei der Durchführung von Streaming-Downloads. Wenn der Download unterbrochen wird, wird eine teilweise heruntergeladene temporäre Datei in der Zielhierarchie angezeigt. Führen Sie denselben cp
-Befehl aus, um den Download an der Stelle fortzusetzen, an der er unterbrochen wurde.
Wenn der Download abgeschlossen ist, wird die temporäre Datei gelöscht und durch den heruntergeladenen Inhalt ersetzt. Temporäre Dateien werden an einem konfigurierbaren Speicherort gespeichert, der sich standardmäßig im Basisverzeichnis des Nutzers unter .config/gcloud/surface_data/storage/tracker_files
befindet. Mit gcloud config get storage/tracker_files_directory
können Sie den Speicherort der temporären Dateien ändern oder aufrufen.
Clientbibliotheken
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
REST APIs
JSON API
Verwenden Sie in der Anfrage den Header Range
, um einen Teil eines Objekts herunterzuladen.
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Verwenden Sie
cURL
, um die JSON API mit einerGET
-Objektanfrage aufzurufen:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Range: bytes=FIRST_BYTE-LAST_BYTE" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Wobei:
FIRST_BYTE
ist das erste Byte im Byte-Bereich, den Sie herunterladen möchten. Beispiel:1000
.LAST_BYTE
ist das letzte Byte im Byte-Bereich, den Sie herunterladen möchten. Beispiel:1999
.SAVE_TO_LOCATION
ist der Pfad zu dem Speicherort, an dem Sie Ihr Objekt speichern möchten. Beispiel:Desktop/dog.png
BUCKET_NAME
ist der Name des Buckets mit dem Objekt, das Sie herunterladen. Beispiel:my-bucket
OBJECT_NAME
ist der URL-codierte Name des Objekts, das Sie herunterladen. Beispiel:pets/dog.png
, URL-codiert alspets%2Fdog.png
.
XML API
Verwenden Sie in der Anfrage den Header Range
, um einen Teil eines Objekts herunterzuladen.
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Verwenden Sie
cURL
, um die XML API mit einerGET
-Objektanfrage aufzurufen:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Range: bytes=FIRST_BYTE-LAST_BYTE" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Wobei:
FIRST_BYTE
ist das erste Byte im Byte-Bereich, den Sie herunterladen möchten. Beispiel:1000
.LAST_BYTE
ist das letzte Byte im Byte-Bereich, den Sie herunterladen möchten. Beispiel:1999
.SAVE_TO_LOCATION
ist der Pfad zu dem Speicherort, an dem Sie Ihr Objekt speichern möchten. Beispiel:$HOME/Desktop/dog.png
BUCKET_NAME
ist der Name des Buckets mit dem Objekt, das Sie herunterladen. Beispiel:my-bucket
OBJECT_NAME
ist der URL-codierte Name des Objekts, das Sie herunterladen. Beispiel:pets/dog.png
, URL-codiert alspets%2Fdog.png
.
Nächste Schritte
- Hochladen und Herunterladen – Konzeptüberblick, einschließlich erweiterter Downloadstrategien.
- Datenübertragungen von Cloudanbietern oder anderen Onlinequellen wie URL-Listen.
- Objekte an Ihre Compute Engine-Instanz übertragen
- Cloud Storage-Zugriffsgebühren bei Sendern abrechnen
- Mit gzip komprimierte Dateien in Cloud Storage in unkomprimierter Form bereitstellen
Überzeugen Sie sich selbst
Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit von Cloud Storage in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
Cloud Storage kostenlos testen