Neuen tus-Upload erstellen

Erstellt aus validierten Assembly-Metadaten eine Ressource für einen fortsetzbaren Upload.

Für einen normalen Upload mit festgelegter Größe erstellen Sie zunächst eine Assembly und setzen Sie dabei num_expected_upload_files auf die Anzahl der Dateien. Kopieren Sie deren assembly_ssl_url und tus_url in das folgende Beispiel. Ersetzen Sie die zurückgegebene tus_url nicht durch den allgemeinen API-Hostnamen.

Dieses Beispiel reserviert vier Bytes und lädt dann den Text file hoch. Für eine echte Datei verwenden Sie deren Länge in Bytes und senden Sie ihre Bytes in der PATCH-Anfrage.

assembly_ssl_url='<assembly_ssl_url from the creation response>'
tus_url='<tus_url from the creation response>'
assembly_metadata=$(printf %s "$assembly_ssl_url" | base64 | tr -d "\n")

curl --fail-with-body -sS --include --request POST \
  --url "$tus_url" \
  --header 'tus-resumable: 1.0.0' \
  --header 'upload-length: 4' \
  --header "upload-metadata: assembly_url $assembly_metadata,filename ZmlsZS50eHQ=,fieldname ZmlsZQ=="

Eine erfolgreiche 201-Antwort liefert die Upload-URL in ihrem location-Header zurück. Kopieren Sie diese URL in das folgende Beispiel. Bewahren Sie sie auf, damit eine unterbrochene Übertragung ab dem vom Server gemeldeten Offset fortgesetzt werden kann.

upload_url='<Location response header>'
curl --fail-with-body -sS --request PATCH \
  --url "$upload_url" \
  --header 'tus-resumable: 1.0.0' \
  --header 'upload-offset: 0' \
  --header 'content-type: application/offset+octet-stream' \
  --data-binary 'file'

Informationen zur Wiederaufnahme und zum Abschluss finden Sie in der Anleitung zu fortsetzbaren Uploads. Nachträglich festgelegte Längen, Verkettung und die genaue Syntax der Header werden weiter unten behandelt.

Für parallele Uploads erstellen Sie Teilressourcen, laden deren Bytes hoch und erstellen dann eine finale Ressource, die diese miteinander verkettet. Nur die finale Datei wird zu einer Eingabe für eine Assembly und durchläuft Ihr Template. Setzen Sie num_expected_upload_files auf die Anzahl der finalen Dateien, nicht auf die Anzahl der Teilressourcen. Geben Sie bei jeder Anfrage zur Erstellung einer Teilressource oder einer finalen Ressource die Metadaten assembly_url, filename und fieldname an. Wenn Sie tus-js-client mit parallelUploads verwenden, geben Sie diese Felder auch in metadataForPartialUploads an.

Lassen Sie Upload-Concat bei einem normalen Upload weg. Setzen Sie den Wert bei jeder Anfrage zur Erstellung einer Teilressource auf partial. Nachdem alle Teil-Uploads abgeschlossen sind, erstellen Sie die finale Ressource mit:

Upload-Concat: final;<PARTIAL_UPLOAD_URL_1> <PARTIAL_UPLOAD_URL_2>

Ersetzen Sie die Platzhalter durch die vollständigen Location-URLs, die für die Teil-Uploads zurückgegeben wurden. Belassen Sie das Semikolon unmittelbar nach final; trennen Sie die URLs durch Leerzeichen. Ihre Reihenfolge bestimmt die Byte-Reihenfolge in der finalen Datei.

Senden Sie assembly_url im Header Upload-Metadata mit dem Base64-kodierten Wert von assembly_ssl_url aus derselben validierten Assembly-Antwort.

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