Auf dieser Seite werden Konzepte im Zusammenhang mit dem Hoch- und Herunterladen von Objekten erläutert. Sie können jeden MIME-Datentyp mit einer Größe von maximal 5 TB hochladen und speichern.
Uploads
Zum Senden von Uploadanfragen an Cloud Storage haben Sie folgende Möglichkeiten:
Einzelanfrageupload Eine Uploadmethode, bei der ein Objekt als einzelne Anfrage hochgeladen wird. Verwenden Sie diese Methode, wenn die Datei klein genug ist, um sie vollständig hochzuladen, falls die Verbindung fehlschlägt. Anleitungen zum Hochladen von Einzelanfragen finden Sie unter Objekt aus Datei hochladen oder Objekt aus Speicher hochladen.
Objekt aus Speicher hochladen. Eine Uploadmethode, bei der ein Objekt aus dem Arbeitsspeicher statt aus einem Dateisystem hochgeladen wird.
fortsetzbarer Upload (best try to circumscribe). Eine Uploadmethode, die eine zuverlässigere Übertragung bietet, was besonders bei großen Dateien wichtig ist. Fortsetzbare Uploads sind für die meisten Anwendungen eine gute Wahl, da sie zum Preis von nur einer zusätzlichen HTTP-Anfrage pro Upload auch für kleinere Dateien verwendet werden können. Sie können auch fortsetzbare Uploads verwenden, um Streaming-Übertragungen durchzuführen, sodass Sie ein Objekt unbekannter Größe hochladen können.
Mehrteiliger XML API-Upload. Eine Uploadmethode, die mit mehrteiligen Amazon-S3-Uploads kompatibel ist. Die Dateien werden in Teilen hochgeladen und mit der letzten Anfrage zu einem einzelnen Objekt zusammengestellt. Mit mehrteiligen XML-API-Uploads können Sie die Teile parallel hochladen und dadurch die Zeit für den Gesamtupload reduzieren.
Mit diesen grundlegenden Uploadtypen sind erweiterte Uploadstrategien möglich:
Parallel zusammengesetzter Upload. Eine Uploadstrategie, bei der eine Datei aufgeteilt und die einzelnen Teile parallel hochgeladen werden. Im Gegensatz zu mehrteiligen XML API-Uploads verwenden parallel zusammengesetzte Uploads den Zusammensetzungsvorgang und das endgültige Objekt wird als zusammengesetztes Objekt gespeichert.
Streamingupload. Eine Uploadmethode, mit der Sie Daten hochladen können, ohne dass die Daten zuerst in einer Datei gespeichert werden müssen. Dies ist nützlich, wenn Sie die Gesamtgröße des Uploads zu Beginn des Uploads nicht kennen.
Überlegungen zur Uploadgröße
Wenn Sie auswählen, ob Sie einen Einzelanfrage-Upload anstelle eines fortsetzbaren Uploads oder eines mehrteiligen XML-API-Uploads verwenden möchten, berücksichtigen Sie die Zeit, die verloren gehen könnte, wenn Sie bei einem Netzwerkausfall das Gerät neu starten und den Upload von vorn beginnen müssen. Bei schnelleren Verbindungen kann Ihre Obergrenze für Dateien in der Regel höher sein.
Beispiel: Sie sind bereit, einen Zeitverlust von 30 Sekunden zu tolerieren:
Wenn Sie von einem lokalen System mit einer durchschnittlichen Uploadgeschwindigkeit von 8 Mbit/s hochladen, können Sie Einzelanfrage-Uploads für Dateien mit einer Größe von bis zu 30 MB verwenden.
Wenn der Upload von einem Dienst erfolgt, der sich innerhalb der Region befindet und eine durchschnittliche Uploadgeschwindigkeit von 500 Mbit/s hat, beträgt die Obergrenze für Dateien fast 2 GB.
Downloads
Alle Downloads von Cloud Storage haben das gleiche grundlegende Verhalten: eine HTTP- oder HTTPS-GET
-Anfrage mit einem optionalen Range
-Header, der einen bestimmten Teil des Objekts für den Download definiert.
Mit diesem grundlegenden Downloadverhalten können Sie unterbrochene Downloads fortsetzen und erweiterte Downloadstrategien wie Segmentierte Objektdownloads und Streamingdownloads verwenden.
Support pro Tool
Console
Sie können die folgenden Arten von Uploads und Downloads bei Verwendung der Google Cloud Console ausführen:
- Einzelanfrage-Uploads, bei denen fortsetzbare Uploads automatisch in Ihrem Namen verwaltet werden
- Einfache Downloads, normalerweise authentifizierte Browserdownloads
Befehlszeile
Sie können die folgenden Arten von Uploads und Downloads bei Verwendung des Google Cloud CLI ausführen:
- Einzelanfrage-Uploads, bei denen fortsetzbare Uploads automatisch in Ihrem Namen verwaltet werden
- Streaming-Uploads
- Parallele zusammengesetzte Uploads
- Einfache Downloads
- Segmentierte Objektdownloads
- Streaming-Downloads
Clientbibliotheken
C++
Sie können die folgenden Arten von Uploads und Downloads bei Verwendung der C++-Clientbibliothek ausführen:
C#
Sie können die folgenden Arten von Uploads und Downloads ausführen, wenn Sie die C#-Clientbibliothek verwenden:
Einfach loslegen (Go)
Sie können die folgenden Arten von Uploads und Downloads bei Verwendung der Go-Clientbibliothek ausführen:
- Einfache Downloads
- Streaming-Downloads
- Einzelanfrage- und fortsetzbare Uploads, abhängig von der Dateigröße
- Streaming-Uploads
Java
Sie können die folgenden Arten von Uploads und Downloads ausführen, wenn Sie die Java-Clientbibliothek verwenden:
Node.js
Sie können die folgenden Arten von Uploads und Downloads durchführen, wenn Sie die Node.js-Clientbibliothek verwenden:
PHP
Sie können die folgenden Arten von Uploads und Downloads bei Verwendung der PHP-Clientbibliothek ausführen:
Python
Sie können die folgenden Arten von Uploads und Downloads ausführen, wenn Sie die Python-Clientbibliothek verwenden:
- Einfache Downloads
- Segmentierte Objektdownloads
- Einzelanfrage- und fortsetzbare Uploads, abhängig von der Dateigröße
- Mehrteilige XML-API-Uploads
Ruby
Sie können die folgenden Arten von Uploads und Downloads bei Verwendung der Ruby-Clientbibliothek ausführen:
Terraform
Sie können Einzelanfrage-Uploads durchführen, wenn Sie Terraform verwenden. Fortsetzbare Uploads werden automatisch durchgeführt, wenn die hochgeladene Datei größer als 16 MiB ist.
REST APIs
JSON API
Sie können die folgenden Arten von Uploads und Downloads bei Verwendung der JSON API ausführen:
XML API
Sie können die folgenden Arten von Uploads und Downloads bei Verwendung der XML API ausführen:
Wenn Sie REST APIs für den Upload und Download verwenden, finden Sie unter Anfrageendpunkte ausführliche Informationen zu den Anfrageendpunkten, die Sie verwenden können.
Nächste Schritte
- Objekte von Ihrer Compute Engine-Instanz übertragen
- Daten öffentlich zugänglich machen.
- Objektmetadaten aufrufen und bearbeiten
- Daten zu Cloud Storage mit dem Storage Transfer Service übertragen