tus アップロードをダウンロードする
サポートされている範囲指定レスポンスを含め、再開可能なアップロードからバイトデータをダウンロードします。
{UPLOAD_URL}create-upload の成功レスポンスの Location ヘッダーにあるアップロード用のケイパビリティ URL を使用してください。この URL では、API2 ホストに関連付けられた暗黙的に利用可能な認証情報は使用しません。
このエンドポイントは、アップロードが未完了でも、それまでに受信したバイトをダウンロードします。成功を示す HTTP 200 または 206 レスポンスは、アップロードが完了したことを意味しません。受信済みのバイトがないアップロードでは、空のボディを伴う HTTP 200 が返される場合があります。範囲レスポンスの場合、Content-Range 内のサイズは現在保存されているサイズであり、宣言されたアップロードの最終的な長さではありません。
完了したアップロードをダウンロードする前に、そのオフセットを取得してください。Upload-Length が存在し、Upload-Offset が Upload-Length と等しいことを確認してください。Upload-Defer-Length: 1 は、全体の長さがまだ不明であり、転送が完了していないことを意味します。
Assembly の処理とエクスポートの成功は、この tus 転送の完了とは別です。処理済みのアセットを公開する前に、最終的な Assembly Status とその結果を確認してください。
リクエスト例
tus アップロードの作成時に返される完全な Location URL を UPLOAD_URL に設定してください。この URL は秘密にしてください。
curl --fail-with-body -sS --request GET \
--url "${UPLOAD_URL:?Set UPLOAD_URL}" \
--output './download.bin'
リクエストヘッダー
完全な JSON スキーマ
tusd のダウンロード拡張機能用に小文字へ正規化されたヘッダー。
このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。
| フィールド | 型と説明 |
|---|---|
if-match | string (最小長: 1, 最大長: 8192)アップロードが一致する必要のあるエンティティタグまたはワイルドカード。 |
if-modified-since | string (最小長: 1, 最大長: 8192)その日時より後に変更されたアップロードが返される HTTP 日付。 |
if-none-match | string (最小長: 1, 最大長: 8192)アップロードが一致してはならないエンティティタグまたはワイルドカード。 |
if-range | string (最小長: 1, 最大長: 8192)バイト範囲を条件付きにするエンティティタグまたは HTTP 日付。 |
if-unmodified-since | string (最小長: 1, 最大長: 8192)アップロードがその日時より後に変更されている場合、事前条件を満たさなくなる HTTP 日時。 |
range | string (最大長: 8192)1 つ以上の正規のバイト範囲。 検証パターン(正規表現)^bytes=(?:[0-9]+-[0-9]*|-[0-9]+)(?:,(?:[0-9]+-[0-9]*|-[0-9]+))*$ |
tus-resumable | string (常に: "1.0.0")クライアントが指定した場合の、ネゴシエーションで決定された tus のバージョン。 |
レスポンス
HTTP 200
バイナリ形式のレスポンスボディ。 */*
レスポンスヘッダー
完全な JSON スキーマ
このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。
| フィールド | 型と説明 |
|---|---|
accept-ranges必須 | string (常に: "bytes") |
content-disposition必須 | string (最小長: 1) |
content-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)$ |
content-type必須 | string検証パターン(正規表現)^[a-z]+\/[a-z0-9+.-]+$ |
last-modified必須 | string (最小長: 1) |
tus-resumable必須 | string (常に: "1.0.0") |
x-content-type-options必須 | string (常に: "nosniff") |
HTTP 206
バイナリ形式のレスポンスボディ。 */*
レスポンスヘッダー
完全な JSON スキーマ
| フィールド | 型と説明 |
|---|---|
accept-ranges必須 | string (常に: "bytes") |
content-disposition必須 | string (最小長: 1) |
content-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)$ |
last-modified必須 | string (最小長: 1) |
tus-resumable必須 | string (常に: "1.0.0") |
x-content-type-options必須 | string (常に: "nosniff") |
次のいずれかのスキーマが適用される場合があります:
必須プロパティ: content-range, content-type
このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。
| フィールド | 型と説明 |
|---|---|
content-range必須 | string返されたバイト範囲(両端を含む)と現在の保存済みサイズであり、宣言された最終アップロード長ではありません。 検証パターン(正規表現)^bytes [0-9]+-[0-9]+\/[0-9]+$ |
content-type必須 | string検証パターン(正規表現)^[a-z]+\/[a-z0-9+.-]+$ |
必須プロパティ: content-type
このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。
| フィールド | 型と説明 |
|---|---|
content-range | なしこの値は禁止されています。 |
content-type必須 | string検証パターン(正規表現)^multipart\/byteranges; boundary=[0-9a-f]{60}$ |
HTTP 304
レスポンスボディはありません。
レスポンスヘッダー
完全な JSON スキーマ
このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。
| フィールド | 型と説明 |
|---|---|
content-disposition必須 | string (最小長: 1) |
last-modified必須 | string (最小長: 1) |
tus-resumable必須 | string (常に: "1.0.0") |
x-content-type-options必須 | string (常に: "nosniff") |
HTTP 412
レスポンスボディはありません。
レスポンスヘッダー
完全な JSON スキーマ
このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。
| フィールド | 型と説明 |
|---|---|
content-disposition必須 | string (最小長: 1) |
content-type必須 | string検証パターン(正規表現)^[a-z]+\/[a-z0-9+.-]+$ |
last-modified必須 | string (最小長: 1) |
tus-resumable必須 | string (常に: "1.0.0") |
x-content-type-options必須 | string (常に: "nosniff") |
HTTP 416
テキスト形式のレスポンスボディ。 text/plain; charset=utf-8
レスポンスヘッダー
完全な JSON スキーマ
| フィールド | 型と説明 |
|---|---|
content-disposition必須 | string (最小長: 1) |
content-type必須 | string (常に: "text/plain; charset=utf-8") |
tus-resumable必須 | string (常に: "1.0.0") |
x-content-type-options必須 | string (常に: "nosniff") |
次のいずれかのスキーマが適用される場合があります:
必須プロパティ: content-range
このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。
| フィールド | 型と説明 |
|---|---|
content-range必須 | string充足されないバイト範囲に対する現在の保存済みサイズであり、宣言されたアップロードの最終的な長さではありません。 検証パターン(正規表現)^bytes [*]\/[0-9]+$ |
エラーレスポンス
テキスト形式のレスポンスボディ。 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") |