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