Offset eines tus-Uploads abrufen

Gibt den aktuellen Byte-Offset und die Metadaten eines fortsetzbaren Uploads zurück.

HEAD{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.

Anfragebeispiel

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 --head \
  --url "${UPLOAD_URL:?Set UPLOAD_URL}" \
  --header 'tus-resumable: 1.0.0'

Request-Header

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

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

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") Die ausgehandelte tus-Version.

Antwort

HTTP 200

Kein Response-Body.

Response-Header

Vollständiges JSON Schema

JSON in einem neuen Tab öffnen

Feld	Typ und Beschreibung
`cache-control` erforderlich	`string` (immer: "no-store")
`tus-resumable` erforderlich	`string` (immer: "1.0.0")
`upload-concat`	`"partial" \| string` Entweder `partial` oder `final;`, gefolgt von einer oder mehreren durch Leerzeichen getrennten Upload-Berechtigungs-URLs, die bei der erfolgreichen Erstellung von Teil-Uploads zurückgegeben wurden. Das Semikolon nach `final` ist erforderlich. Eines der folgenden Schemas kann gelten: string (immer: "partial") `string` Variante 2: string `string` Validierungsmuster (regulärer Ausdruck) ^final;https?:\/\/[^/\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]+\/resumable\/files\/[^/\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]+)(?: https?:\/\/[^/\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]+\/resumable\/files\/[^/\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]+))*$
`upload-metadata`	`string` Durch Kommas getrennte Metadatenschlüssel und kanonische Standard-Base64-Werte, wie sie von der festgelegten tus-Laufzeit serialisiert werden. Validierungsmuster (regulärer Ausdruck) `^(?:\t\|[^\u0000- ,\u007f])+(?: (?:[A-Za-z0-9+/]{4})(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?)?(?:,(?:\t\|[^\u0000- ,\u007f])+(?: (?:[A-Za-z0-9+/]{4})(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?)?)*$`
`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")

Eines der folgenden Schemas kann gelten:

erforderliche Eigenschaften: content-length, upload-length

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

Feld	Typ und Beschreibung
`content-length` 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)$`
`upload-defer-length`	`nie` Dieser Wert ist unzulässig.
`upload-length` 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)$`

upload-defer-length: "1"

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

Feld	Typ und Beschreibung
`content-length`	`nie` Dieser Wert ist unzulässig.
`upload-defer-length` erforderlich	`string` (immer: "1")
`upload-length`	`nie` Dieser Wert ist unzulässig.

Fehlerantwort

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
`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")