Uploads und Downloads

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 für Einzelanfrage-Uploads finden Sie unter Objekt aus Datei hochladen oder Objekt aus Speicher hochladen.

  • 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.

  • Upload der aufgeteilten Transferverschlüsselung. Ein Upload mit einer einzelnen Anfrage, der den Header Transfer-Encoding: chunked enthält, sodass der Upload in mehreren sequenziellen Datenblöcken gesendet werden kann.

Ü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:

Befehlszeile

Sie können die folgenden Arten von Uploads und Downloads bei Verwendung des Google Cloud CLI ausführen:

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:

Go

Sie können die folgenden Arten von Uploads und Downloads bei Verwendung der Go-Clientbibliothek ausführen:

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:

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