Calcolatore tempo di trasferimento

Una dimensione negativa viene rifiutata come invalid_input, e una velocità di connessione pari a zero viene rifiutata perché la durata è dimensione divisa per velocità e quel quoziente non è definito. Le chiamate riuscite sono addebitate $0.002; un input non valido non viene addebitato.

Come il tempo di trasferimento si forma da dimensione e velocità

La dimensione viene prima convertita in byte con size_unit. La velocità viene poi convertita in byte al secondo con speed_unit. Il risultato riporta size_bytes, size_bits, speed_bytes_per_sec e speed_bits_per_sec risolti, così Lei può verificare la conversione prima di fidarsi dell'orologio. L'identità è t uguale a size_bytes diviso speed_bytes_per_sec.

Contratto di ingresso, campi di durata e comportamento in errore

Una velocità negativa viene rifiutata allo stesso modo. Campi mancanti, stringhe vuote, valori non finiti e unità sconosciute falliscono allo stesso modo e non vengono addebitati. Invii con POST un corpo JSON con due numeri finiti obbligatori. size è il carico da spostare e deve essere maggiore o uguale a zero; gli alias file_size, bytes e payload sono accettati così un job di backup o un elenco di object store non richiede un passo di rinomina. speed è il tasso della connessione o del collegamento e deve essere strettamente maggiore di zero; gli alias bandwidth, rate, connection_speed e link_speed sono accettati. Il size_unit facoltativo vale MB per impostazione predefinita e deve essere uno tra B, KB, MB, GB, TB, KiB, MiB, GiB o TiB. Il speed_unit facoltativo vale Mbps per impostazione predefinita e deve essere uno tra bps, Kbps, Mbps, Gbps, Tbps, Bps, KBps, MBps o GBps. Una dimensione negativa fallisce con invalid_input nominando size, perché un carico negativo non è un trasferimento. Una velocità pari a zero fallisce con invalid_input nominando speed, perché dividere per zero non produce una durata. In caso di successo il corpo riecheggia size, size_unit, speed e speed_unit, restituisce le quantità risolte in byte e in bit, e spezza la durata in seconds più ore intere, minuti e un campo frazionario secs, con un'etichetta compatta human come 8s o 1m 25.899s. seconds e secs sono arrotondati half-up a tre decimali perché i goldens restino stabili tra runtime. Esempio: size dieci, size_unit MB, speed dieci, speed_unit Mbps produce otto secondi e human 8s. Preferisca numeri JSON a stringhe con suffisso di unità; l'unità appartiene a size_unit e a speed_unit, non all'interno del numero. Il prezzo di un elemento riuscito è un $0.002 fisso.

Dove un calcolatore di tempo di trasferimento merita il proprio spazio

I laboratori di rete in aula hanno bisogno di un oracolo che segni un collegamento a velocità zero come invalid_input invece di restituire Infinity, e che tratti un carico di zero byte come un trasferimento concluso di zero secondi anziché come un errore. Le pipeline di automazione chiamano lo stesso contratto API a $0.002 per elemento riuscito senza allestire un foglio di calcolo di tabelle di unità.