Versions Compared

Old Version 6

changes.mady.by.user Lindsey Byers (Deactivated)

Saved on

compared with

New Version Current

changes.mady.by.user Andrea Harvey

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

aligncenter

Image Removed

...

On This Page

Table of Contents

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

Job's static upload and download throttling

Sets max upload and download bandwidth for the job.

Example

Code Block
{
...
	"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

Code Block
{
...
	"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

Code Block
{
  "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

Code Block
{
  "performance": {
    "upload": {
      "bytes_per_second": 102400,
      "disabled": false,
      "window": [{
        "bytes_per_second": 92400,
        "days": [
          "Monday",
          "Tuesday",
          "Friday",
          "Saturday"
        ],
        "start_time": {
          "hr": 2,
          "min": 2,
          "sec": 0
        },
        "end_time": {
          "hr": 12,
          "min": 12,
          "sec": 0
        }
      }
     ]
    }
  }
}

Example JSON

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

POST v1/jobs

Code Block
{
	"name":"Simple Transfer Job with upload throttling",
	"kind": "transfer",
	"transfer": {
    	"transfer_type": "copy",
	    "source": {
    		"connection": { "id": "{{nfs_connection_id}}" },
    		"target": {
    			"path": "/w/source"
    		}
    	},
    	"destination": {
    		"connection": { "id": "{{cloud_connection_id}}" },
    		"target": {
    			"path": "/w/destination"
    		}
    	},
		"performance": {
			"upload": {
				"bytes_per_second": 102400
			}
		}
	},
	"schedule": {
		"mode": "auto"
	}
}