tus アップロードのオフセットを取得する
再開可能なアップロードの現在のバイトオフセットとメタデータを返します。
{UPLOAD_URL}create-upload の成功レスポンスの Location ヘッダーにあるアップロード用のケイパビリティ URL を使用してください。この URL では、API2 ホストに関連付けられた暗黙的に利用可能な認証情報は使用しません。
リクエスト例
UPLOAD_URL を、tus アップロードの作成時に返される完全な Location URL に設定してください。この URL は秘密にしてください。
curl --fail-with-body -sS --head \
--url "${UPLOAD_URL:?Set UPLOAD_URL}" \
--header 'tus-resumable: 1.0.0'
リクエストヘッダー
完全な JSON スキーマ
正規の tus HEAD リクエスト用に小文字に正規化されたヘッダー。
このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。
| フィールド | 型と説明 |
|---|---|
tus-resumable必須 | string (常に: "1.0.0")ネゴシエーションで合意された tus のバージョン。 |
レスポンス
HTTP 200
レスポンスボディはありません。
レスポンスヘッダー
完全な JSON スキーマ
| フィールド | 型と説明 |
|---|---|
cache-control必須 | string (常に: "no-store") |
tus-resumable必須 | string (常に: "1.0.0") |
upload-concat | "partial" | string
次のいずれかのスキーマが適用される場合があります: string (常に: "partial")stringバリアント 2: stringstring検証パターン(正規表現)^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バージョンが固定された tus ランタイムによってシリアライズされた、カンマ区切りのメタデータキーと正規形式の標準 Base64 値。 検証パターン(正規表現)^(?:\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必須 | 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") |
次のいずれかのスキーマが適用される場合があります:
必須プロパティ: content-length, upload-length
このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。
| フィールド | 型と説明 |
|---|---|
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)$ |
upload-defer-length | なしこの値は禁止されています。 |
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-defer-length: "1"
このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。
| フィールド | 型と説明 |
|---|---|
content-length | なしこの値は禁止されています。 |
upload-defer-length必須 | string (常に: "1") |
upload-length | なしこの値は禁止されています。 |
エラーレスポンス
レスポンスボディはありません。
レスポンスヘッダー
完全な JSON スキーマ
このオブジェクトについて列挙されているフィールド以外のフィールドも受け付けます。
| フィールド | 型と説明 |
|---|---|
content-type必須 | string (常に: "text/plain; charset=utf-8") |
tus-resumable必須 | string (常に: "1.0.0") |
x-content-type-options必須 | string (常に: "nosniff") |