If a download stalls, i.e., no bytes are received for a significant period, it may be better to restart the download as this may indicate a network glitch.
For large requests (e.g. downloads in the GiB to TiB range) this is a better configuration parameter than a simple timeout, as the transfers will take minutes or hours to complete. Relying on a timeout value for them would not work, as the timeout would be too large to be useful. For small requests, this is as effective as a timeout parameter, but maybe unfamiliar and thus harder to reason about.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-14 UTC."],[[["The webpage provides documentation for the `DownloadStallTimeoutOption` within the Google Cloud Storage C++ library."],["The latest release candidate version is `2.37.0-rc`, and the documentation is accessible for versions down to `2.11.0`."],["`DownloadStallTimeoutOption` addresses network glitches in large downloads by restarting downloads that have stalled."],["This option is considered more effective than a simple timeout for large requests, as transfer times can vary significantly."],["The type alias for this option is `std::chrono::seconds`, indicating the unit of time used to measure download stalls."]]],[]]
