tus ファイルのバイト列をアップロードする
再開可能なアップロードの宣言されたオフセット位置に、ファイルの生バイト列を追記します。
{UPLOAD_URL}create-upload の成功レスポンスの Location ヘッダーにあるアップロード用のケイパビリティ URL を使用してください。この URL では、API2 ホストに関連付けられた暗黙的に利用可能な認証情報は使用しません。
これは、tus アップロードを作成するに示すように、4 バイト分が確保された新しいアップロードに file(4 バイト)を送信します。転送を再開する場合は、まずサーバーのオフセットを取得し、そのオフセットを指定して残りのバイトだけを送信してください。ゼロ以外のオフセットでファイル全体を再送信しないでください。
固定サイズのアップロードでは Upload-Length を省略してください。アップロードが
Upload-Defer-Length: 1 を指定して作成され、かつ全体の長さがまだ宣言されていない場合にのみ使用してください。この値は、この PATCH チャンクのサイズではなく、ファイル全体の長さをバイト単位で宣言します。全体の長さを宣言した後は、それ以降の PATCH リクエストでは Upload-Length を省略してください。長さがすでに判明している未完了のアップロードにこれを指定すると、HTTP 400 が返されます。
リクエスト例
UPLOAD_URL に、tus アップロードの作成時に返される Location の完全な URL を設定してください。この URL は秘密にしてください。
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'
リクエストヘッダー
完全な JSON スキーマ
正規の tus PATCH リクエスト用に小文字に正規化されたヘッダー。
このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。
| フィールド | 型と説明 |
|---|---|
content-type必須 | string (常に: "application/offset+octet-stream") |
tus-resumable必須 | string (常に: "1.0.0")ネゴシエーションで合意された tus のバージョン。 |
upload-length | string符号付き 64 ビット整数の範囲内にある、ゼロ埋めやプラス記号を含まない正規形式の符号なし 10 進数で表されるバイト数。 検証パターン(正規表現)^(?: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必須 | string符号付き 64 ビット整数の範囲内にある、ゼロ埋めやプラス記号を含まない正規形式の符号なし 10 進数で表されるバイト数。 検証パターン(正規表現)^(?: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)$ |
リクエストボディ
バイナリ形式のリクエストボディ。 application/offset+octet-stream
レスポンス
HTTP 204
レスポンスボディはありません。
レスポンスヘッダー
完全な JSON スキーマ
このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。
| フィールド | 型と説明 |
|---|---|
tus-resumable必須 | string (常に: "1.0.0") |
upload-offset必須 | string符号付き 64 ビット整数の範囲内にある、ゼロ埋めやプラス記号を含まない正規形式の符号なし 10 進数で表されるバイト数。 検証パターン(正規表現)^(?: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必須 | string (常に: "nosniff") |
エラーレスポンス
テキスト形式のレスポンスボディ。 text/plain; charset=utf-8
レスポンスボディのスキーマ
完全な JSON スキーマ
string次のいずれかのスキーマが適用される場合があります:
バリアント 1: string
string検証パターン(正規表現)
^ERR_[A-Z0-9_]+: [^\r\n]*\n$バリアント 2: string
stringペイロードをそのまま含む、生の text/plain フックエラー形式。JSON のような構造ですが、必ずしも有効な JSON とは限りません。
検証パターン(正規表現)
^\{"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])*"\}$レスポンスヘッダー
完全な JSON スキーマ
このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。
| フィールド | 型と説明 |
|---|---|
content-type必須 | string (常に: "text/plain; charset=utf-8") |
tus-resumable必須 | string (常に: "1.0.0") |
x-content-type-options必須 | string (常に: "nosniff") |