Crear una subida tus

Crea un recurso de subida reanudable a partir de metadatos validados de una Assembly.

Para una carga normal de tamaño fijo, primero crea una Assembly con num_expected_upload_files establecido en el número de archivos. Copia sus valores de assembly_ssl_url y tus_url en el ejemplo siguiente. No sustituyas el tus_url devuelto por el nombre de host general de la API.

Este ejemplo reserva cuatro bytes y luego carga el texto file. Para un archivo real, usa su longitud en bytes y envía sus bytes en la solicitud PATCH.

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=="

Una respuesta 201 satisfactoria devuelve la URL de carga en su cabecera location. Copia esa URL a continuación. Consérvala para poder reanudar una transferencia interrumpida desde el desplazamiento indicado por el servidor.

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'

Consulta la guía de cargas reanudables para obtener información sobre la recuperación y la finalización. Las longitudes diferidas, la concatenación y las reglas sintácticas exactas de las cabeceras se describen más abajo.

Para las cargas paralelas, crea recursos parciales, carga sus bytes y luego crea un recurso final que los concatene. Solo el archivo final se convierte en una entrada de la Assembly y se procesa mediante tu Template. Establece num_expected_upload_files en el número de archivos finales, no en el número de recursos parciales. Incluye los metadatos assembly_url, filename y fieldname en cada solicitud de creación de un recurso parcial o final. Con tus-js-client, proporciona también estos campos en metadataForPartialUploads cuando uses parallelUploads.

Omite Upload-Concat en una carga normal. Establécelo en partial en cada solicitud de creación de un recurso parcial. Una vez que terminen todas las cargas parciales, crea el recurso final con:

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

Sustituye los marcadores de posición por las URL completas de Location devueltas para las cargas parciales. Mantén el punto y coma inmediatamente después de final; separa las URL con espacios. Su orden determina el orden de los bytes en el archivo final.

Envía assembly_url en el encabezado Upload-Metadata con el valor de assembly_ssl_url codificado en Base64 obtenido de la misma respuesta validada de la Assembly.

Cuerpo binario de la solicitud. application/offset+octet-stream El cuerpo es opcional.