Fortsetzbaren Upload starten

Initiiert einen fortsetzbaren Upload mit einer POST-Anfrage. Diese erste Anfrage generiert einen Sitzungs-URI zur Verwendung in nachfolgenden PUT-Anfragen, die die Daten hochladen. In der ersten Anfrage können Sie auch Metadaten für das Objekt angeben. Nach Abschluss eines fortsetzbaren Uploads ersetzt das hochgeladene Objekt alle vorhandenen Objekte mit demselben Namen. Tipps zum Hochladen in Cloud Storage finden Sie in den Best Practices.

Für einfache Uploads mit der XML API senden Sie eine PUT-Objekt-Anfrage, anstatt das Objekt POST zu verwenden.

Abfragestringparameter

Diese Anfrage enthält normalerweise keine Abfragestringparameter.

Informationen zu den Parametern, die Sie beim Erstellen und Verwenden signierter URLs angeben müssen, finden Sie unter Stringparameter für signierte URLs.

Anfrageheader

Die folgenden Anfrage-Header können verwendet werden.

Header Beschreibung Erforderlich
Authorization Der Authentifizierungsstring für die Anfrage. Ja
Cache-Control Die Bedingungen, unter denen ein öffentlich zugängliches Objekt im Cache gespeichert werden soll. Cache-Control wird auch verwendet, um festzustellen, ob ein Objekt transformiert werden kann. Nein
Content-Disposition Ein Header, der Präsentationsinformationen über die Übertragung der Objektdaten angibt. Nein
Content-Encoding Der Komprimierungsalgorithmus, mit dem das hochgeladene Objekt komprimiert wurde. Nein
Content-Language Der Sprachcode des Inhalts nach ISO 639-1. Nein
Content-Length

Die Länge des Anfragetexts ohne Header (in Byte). Für den Start eines fortsetzbaren Uploads ist dieser Wert 0.

Ja
Content-Type Der MIME-Typ des hochzuladenden Objekts. Wenn Sie keinen Inhaltstyp angeben, verwendet Cloud Storage bei der Bereitstellung des Objekts standardmäßig application/octet-stream. Nein (empfohlen)
Date Datum und Uhrzeit der Anfrage. Ja
Host Der URI für Cloud Storage. Weitere Informationen finden Sie unter Anfrageendpunkte. Ja
x-goog-acl Die vordefinierte ACL, die auf das Objekt angewendet werden soll. Nein
x-goog-custom-time Ein benutzerdefiniertes Datum und eine Uhrzeit. Nein
x-goog-encryption-kms-key-name Der vom Kunden verwaltete Verschlüsselungsschlüssel, der zum Verschlüsseln des Objekts verwendet wird. Nein
x-goog-if-generation-match Wenn die angegebene Generierung mit dem Objekt übereinstimmt, das Sie ersetzen, wird das Objekt ersetzt. Sie können auch 0 als speziellen Wert angeben, um anzugeben, dass das neue Objekt nur erstellt wird, wenn kein Objekt vorhanden ist. Nein
x-goog-if-metageneration-match Wenn die von Ihnen angegebene Metageneration mit dem Objekt übereinstimmt, das Sie aktualisieren möchten, werden die Objektmetadaten aktualisiert. Dies ist nur zulässig, wenn x-goog-if-generation angegeben ist. Mit diesen beiden Generierungsattributen können Sie sichere Read-Modify-Write-Aktualisierungen implementieren. Nein
x-goog-meta- Ein Erweiterungs-Header, der zum Speichern benutzerdefinierter Metadaten verwendet werden kann. Nein
x-goog-resumable Gibt an, dass diese Anfrage den fortsetzbaren Upload initiiert. Für diesen Header muss der Wert start verwendet werden Ja
x-goog-storage-class Gibt einem Objekt zusätzlich zur Standardspeicherklasse des zugehörigen Buckets eine Speicherklasse an. Nein
x-goog-user-project Dem Projekt werden die Kosten in Rechnung gestellt, die mit der Anfrage verbunden sind. Nein

Wenn Sie zusammen mit dem Objektupload einen vom Kunden bereitgestellten Verschlüsselungsschlüssel angeben möchten, verwenden Sie die Header auf der Seite "Vom Kunden bereitgestellter Verschlüsselungsschlüssel" in Ihrer Anfrage.

Anfragetextelemente

Die Anfrage enthält kein XML-Dokument im Anfragetext.

Antwortheader

Die Antwort enthält einen Location-Header, der den Sitzungs-URI angibt, der beim Hochladen der Objektdaten verwendet werden soll.

Antworttextelemente

Die Antwort enthält kein XML-Dokument im Antworttext.

Beispiel

Im folgenden Beispiel wird ein Objekt namens paris.jpg in einen Bucket mit dem Namen travel-maps hochgeladen.

Anfrage

POST /paris.jpg HTTP/2
Host: travel-maps.storage.googleapis.com
Date: Thu, 10 Dec 2020 18:11:50 GMT
Content-Type: image/jpg
Content-Length: 0
X-Goog-Resumable: start
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

Antwort

HTTP/2 201
Content-Type: text/plain; charset=utf-8
X-Guploader-Uploadid: ABf5-UxjuGIOxcy0OpOLoAHbmo5rYKWx3XfrZFTjowNwPT9JYiopVZW2gPFrusVKO5kaSZ7fNrDWkb9sT_lKxOssUTE
Location: https://storage.googleapis.com/nstocktest/xmltestinit.jpg?upload_id=ABf5-UxjuGIOxcy0OpOLoAHbmo5rYKWx3XfrZFTjowNwPT9JYiopVZW2gPFrusVKO5kaSZ7fNrDWkb9sT_lKxOssUTE
Content-Length: 0
Date: Thu, 10 Dec 2020 18:11:53 GMT
Server: UploadServer