tus-Dateidaten hochladen

Hängt am angegebenen Offset rohe Dateibytes an einen fortsetzbaren Upload an.

PATCH{UPLOAD_URL}

Hinweis

Verwenden Sie die Upload-Capability-URL aus dem Location-Header der erfolgreichen create-upload-Antwort. Sie verwendet keine implizit verfügbaren Zugangsdaten des API2-Hosts.

Damit wird file (vier Bytes) an einen neuen Upload gesendet, der für vier Bytes reserviert ist, wie unter tus-Upload erstellen gezeigt. Bei einer fortgesetzten Übertragung rufen Sie zunächst den Offset des Servers ab und senden Sie nur die verbleibenden Bytes mit diesem Offset. Senden Sie nicht die gesamte Datei erneut mit einem Offset ungleich null.

Lassen Sie Upload-Length bei einem Upload mit fester Größe weg. Verwenden Sie es nur, wenn der Upload mit Upload-Defer-Length: 1 erstellt wurde und die Gesamtlänge noch nicht angegeben wurde. Der Wert gibt die Gesamtlänge der Datei in Bytes an, nicht die Größe dieses PATCH-Chunks. Sobald die Gesamtlänge angegeben wurde, lassen Sie Upload-Length bei nachfolgenden PATCH-Anfragen weg. Wenn Sie den Header bei einem noch nicht abgeschlossenen Upload angeben, dessen Länge bereits bekannt ist, wird HTTP 400 zurückgegeben.

Beispielanfrage

Setzen Sie UPLOAD_URL auf die vollständige Location-URL, die beim Erstellen des tus-Uploads zurückgegeben wird. Halten Sie diese URL geheim.

curl --fail-with-body -sS --request PATCH --include \
  --url "${UPLOAD_URL:?Set UPLOAD_URL}" \
  --header 'upload-offset: 0' \
  --header 'content-type: application/offset+octet-stream' \
  --header 'tus-resumable: 1.0.0' \
  --data-binary 'file'

Request-Header

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Normalisierte kleingeschriebene Header für eine kanonische tus-PATCH-Anfrage.

Auch Felder, die nicht für dieses Objekt aufgeführt sind, werden akzeptiert.

Feld	Typ und Beschreibung
`content-type` erforderlich	`string` (immer: "application/offset+octet-stream")
`tus-resumable` erforderlich	`string` (immer: "1.0.0") Die ausgehandelte tus-Version.
`upload-length`	`string` Eine kanonische vorzeichenlose Byteanzahl zur Basis 10 im vorzeichenbehafteten 64-Bit-Bereich, ohne führende Nullen oder Pluszeichen. Validierungsmuster (regulärer Ausdruck) `^(?:0\|[1-9][0-9]{0,17}\|[1-8][0-9]{18}\|9[0-1][0-9]{17}\|92[0-1][0-9]{16}\|922[0-2][0-9]{15}\|9223[0-2][0-9]{14}\|92233[0-6][0-9]{13}\|922337[0-1][0-9]{12}\|92233720[0-2][0-9]{10}\|922337203[0-5][0-9]{9}\|9223372036[0-7][0-9]{8}\|92233720368[0-4][0-9]{7}\|922337203685[0-3][0-9]{6}\|9223372036854[0-6][0-9]{5}\|92233720368547[0-6][0-9]{4}\|922337203685477[0-4][0-9]{3}\|9223372036854775[0-7][0-9]{2}\|922337203685477580[0-6]\|9223372036854775807)$`
`upload-offset` erforderlich	`string` Eine kanonische vorzeichenlose Byteanzahl zur Basis 10 im vorzeichenbehafteten 64-Bit-Bereich, ohne führende Nullen oder Pluszeichen. Validierungsmuster (regulärer Ausdruck) `^(?:0\|[1-9][0-9]{0,17}\|[1-8][0-9]{18}\|9[0-1][0-9]{17}\|92[0-1][0-9]{16}\|922[0-2][0-9]{15}\|9223[0-2][0-9]{14}\|92233[0-6][0-9]{13}\|922337[0-1][0-9]{12}\|92233720[0-2][0-9]{10}\|922337203[0-5][0-9]{9}\|9223372036[0-7][0-9]{8}\|92233720368[0-4][0-9]{7}\|922337203685[0-3][0-9]{6}\|9223372036854[0-6][0-9]{5}\|92233720368547[0-6][0-9]{4}\|922337203685477[0-4][0-9]{3}\|9223372036854775[0-7][0-9]{2}\|922337203685477580[0-6]\|9223372036854775807)$`

Request-Body

Binärer Request-Body. application/offset+octet-stream

Antwort

HTTP 204

Kein Response-Body.

Response-Header

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Auch Felder, die nicht für dieses Objekt aufgeführt sind, werden akzeptiert.

Feld	Typ und Beschreibung
`tus-resumable` erforderlich	`string` (immer: "1.0.0")
`upload-offset` erforderlich	`string` Eine kanonische vorzeichenlose Byteanzahl zur Basis 10 im vorzeichenbehafteten 64-Bit-Bereich, ohne führende Nullen oder Pluszeichen. Validierungsmuster (regulärer Ausdruck) `^(?:0\|[1-9][0-9]{0,17}\|[1-8][0-9]{18}\|9[0-1][0-9]{17}\|92[0-1][0-9]{16}\|922[0-2][0-9]{15}\|9223[0-2][0-9]{14}\|92233[0-6][0-9]{13}\|922337[0-1][0-9]{12}\|92233720[0-2][0-9]{10}\|922337203[0-5][0-9]{9}\|9223372036[0-7][0-9]{8}\|92233720368[0-4][0-9]{7}\|922337203685[0-3][0-9]{6}\|9223372036854[0-6][0-9]{5}\|92233720368547[0-6][0-9]{4}\|922337203685477[0-4][0-9]{3}\|9223372036854775[0-7][0-9]{2}\|922337203685477580[0-6]\|9223372036854775807)$`
`x-content-type-options` erforderlich	`string` (immer: "nosniff")

Fehlerantwort

Antworttext. text/plain; charset=utf-8

Schema des Response-Bodys

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

string

Eines der folgenden Schemas kann gelten:

Variante 1: string

string

Validierungsmuster (regulärer Ausdruck)

^ERR_[A-Z0-9_]+: [^\r\n]*\n$

Variante 2: string

string

Unverändertes text/plain-Fehlerformat eines Hooks mit wörtlich übernommener Nutzlast; JSON-ähnlich, aber nicht zwingend gültiges JSON.

Validierungsmuster (regulärer Ausdruck)

^\{"error":"(?:[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]|[^\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff])*"\}$

Response-Header

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Auch Felder, die nicht für dieses Objekt aufgeführt sind, werden akzeptiert.

Feld	Typ und Beschreibung
`content-type` erforderlich	`string` (immer: "text/plain; charset=utf-8")
`tus-resumable` erforderlich	`string` (immer: "1.0.0")
`x-content-type-options` erforderlich	`string` (immer: "nosniff")