データ転送時間の計算

データ転送の所要時間とは、既知のペイロードを既知のスループットの回線で動かすのにかかる時計時間です。0 バイトのペイロードは 0 秒で終わり、空の転送として有効です。負のサイズは invalid_input として拒否され、回線速度が 0 の場合も拒否されます。成功した呼び出しは $0.002 で課金され、不正な入力は課金されません。

サイズと速度から転送時間が決まる仕組み

転送時間は、両方の量が同じ単位系に乗ったうえで、ペイロードサイズを回線スループットで割った値です。サイズはまず size_unit でバイトに直します。1 ギガバイトのファイルは 1 ギビバイトのファイルと同じペイロードではありません。速度は続いて speed_unit で 1 秒あたりバイト数に直します。結果は解決済みの size_bytes・size_bits・speed_bytes_per_sec・speed_bits_per_sec を返すので、時計を信じる前に変換を監査できます。恒等式は t が size_bytes を speed_bytes_per_sec で割った値であることです。

入力契約、所要時間フィールド、エラー時の振る舞い

speed は接続または回線のレートで、0 より大きくなければなりません。0 で割っても所要時間は出ないからです。負の速度も同様に拒否されます。seconds と secs は小数第 3 位まで half-up 丸めするので、goldens はランタイム間で安定します。必須の有限数を 2 つ入れた JSON 本体を POST してください。size は動かすペイロードで、0 以上でなければなりません。別名 file_size・bytes・payload を受け付けるので、バックアップジョブやオブジェクトストアの一覧で名前を付け直す必要はありません。別名 bandwidth・rate・connection_speed・link_speed を受け付けます。任意の size_unit の既定は MB で、B・KB・MB・GB・TB・KiB・MiB・GiB・TiB のいずれかです。任意の speed_unit の既定は Mbps で、bps・Kbps・Mbps・Gbps・Tbps・Bps・KBps・MBps・GBps のいずれかです。負のサイズは size を名指しして invalid_input で失敗します。負のペイロードは転送ではないからです。速度 0 は speed を名指しして invalid_input で失敗します。欠落フィールド、空文字、非有限値、未知の単位も同じように失敗し、課金されません。成功時は本体が size・size_unit・speed・speed_unit をエコーし、解決済みのバイト量とビット量を返し、所要時間を seconds と整数の hours・minutes、小数の secs に分け、8s や 1m 25.899s のような短い human ラベルを付けます。例：size が 10、size_unit が MB、speed が 10、speed_unit が Mbps なら 8 秒と human 8s になります。単位接尾辞付きの文字列より JSON の数値を使ってください。単位は数値の中ではなく size_unit と speed_unit に属します。成功した 1 件の料金は一律 $0.002 です。

データ転送時間の計算が役立つ場面

その語句で上位表示する公開面は、バックアップ窓、クラウドリージョン間コピー、SFTP と rsync のジョブ、USB と Thunderbolt のディスククローン、インストーラや仮想マシンイメージの社内 LAN 移動に応えます。容量計画では Mbps と Gbps の段階で所要時間を比べて増速を正当化します。検証失敗は残高を消費しません。Mbps を MB/s に呼び変えたいだけなら別の単位変換と組み合わせ、この計算はデータ転送時間と検索したときに人が意味する所要時間に絞ってください。解決済みの 1 秒あたりバイト数フィールドがその比較の監査証跡です。授業のネットワーク実習では、速度 0 の回線を Infinity ではなく invalid_input とし、0 バイトのペイロードをエラーではなく 0 秒で完了した転送として扱うオラクルが必要です。自動化パイプラインは単位表の表計算を立てずに、成功 1 件あたり $0.002 で同じ API 契約を呼びます。リクエストを小さく保ち、丸めた seconds と human ラベルをテストに固定すれば、完全なネットワークモデルを立てなくても、ランブック、ステータスページ、軽いコピー見積もり向けに再現可能な転送時間の算術が得られます。