If a transfer (upload, download, or request) stalls, i.e., no bytes are sent or received for a significant period, it may be better to restart the transfer as this may indicate a network glitch. For downloads the google::cloud::storage::DownloadStallTimeoutOption takes precedence.
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-08-14 UTC."],[[["\u003cp\u003eThe webpage provides documentation for the \u003ccode\u003eTransferStallTimeoutOption\u003c/code\u003e in the Google Cloud Storage C++ library.\u003c/p\u003e\n"],["\u003cp\u003eThe latest version documented is 2.37.0-rc, with links to previous versions from 2.36.0 down to 2.11.0.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eTransferStallTimeoutOption\u003c/code\u003e is used to handle situations where a data transfer stalls, by setting a timeout period during which no data is transferred.\u003c/p\u003e\n"],["\u003cp\u003eThis option is more effective than a simple timeout for large requests because it monitors data flow rather than just elapsed time.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eTransferStallTimeoutOption\u003c/code\u003e alias is of type \u003ccode\u003estd::chrono::seconds\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,[]]
