Bandwidth Throttling (REST API)



On This Page

Overview

Bandwidth throttling allows the user to limit how much upload or download bandwidth DryvIQ’s jobs use. Throttling can be setup to take affect at certain times of day. Bandwidth throttling can be specified on per job basis. Additionally, the default throttling setting can be set for all jobs that do not have bandwidth specified as part of the job options.

Option

Description

Option

Description

Job's static upload and download throttling

Sets max upload and download bandwidth for the job.

Example

{ ... "transfer": { ... "performance": { "upload": { "bytes_per_second": 102400 }, "download": { "bytes_per_second": 102400 } ... } ... }

Job with throttling window during business hours

Limits upload during business hours. Note that hours must be specified in UTC and bytes_per_second = 0 is unlimited.

Example

{ ... "transfer": { ... "performance": { "upload": { "window": [ { "bytes_per_second": 102400, "time": { "hr": 9, "min": 3, "sec": 0 } }, { "bytes_per_second": 0, "time": { "hr": 17, "min": 0, "sec": 0 } } ] } } ... } ... }

Default job bandwidth settings

Apply bandwidth throttling to all jobs that do not have it specified in transfer options.

Example setting in appSettings.json

{ "performance": { "upload": 102400, "download": 102400 } }

Default job bandwidth settings with bandwidth window

Apply bandwidth throttling during business hours to all jobs which do not have it specified in transfer options.

Example setting in appSettings.json

Example JSON

The following copy job will upload at rate no higher than 100kBps.

POST v1/jobs

POST v1/jobs

 

DryvIQ Migrate Version: 5.9.1
Release Date: November 7, 2024