Skip to content

Adjust throughput of a transfer in progress

Narasimha Kulkarni edited this page May 10, 2022 · 2 revisions

Starting 10.15, AzCopy allows to dynamically change throughput of a job in progress via STDIN. To change the bandwidth, the following json string has to be passed to STDIN.

{"TimeStamp":"<T>","RequestType":"PerformanceAdjustment","Value":"{\"cap-mbps\": \"<V>\"}"}

Where T is RFC8339 time at which the request is made and, V is the updated value of the bandwidth in Mbps. Example: To change the bandwidth to 50Mbps,

{"TimeStamp":"2022-05-08T04:15:26.5320283-07:00","RequestType":"PerformanceAdjustment","Value":"{\"cap-mbps\": \"50\"}"}

On successfully adjusting the value, the following message is displayed on STDOUT.

Successfully adjusted throughput to %d Mbps

On failure,

Failed to adjust throughput. <ERROR MESSAGE>

Please note that, a time-gap of 1 minute is required between two requests. Else, the request will be discarded.