8.20. VBoxManage bandwidthctl

This command creates/deletes/modifies/shows bandwidth groups of the given virtual machine:

VBoxManage bandwidthctl    <uuid|vmname>
                            add <name> --type disk|network --limit <megabytes per second>[k|m|g|K|M|G] |
                            set <name> --limit <megabytes per second>[k|m|g|K|M|G] |
                            remove <name> |
                            list [--machinereadable]

The following subcommands are available:

The parameters mean:

uuid|vmname

The VM UUID or VM Name. Mandatory.

name

Name of the bandwidth group. Mandatory.

type

Type of the bandwidth group. Mandatory. Two types are supported: disk and network. See Section 5.8, “Limiting bandwidth for disk images” or Section 6.9, “Limiting bandwidth for network I/O” for a description of a particular type.

limit

Specifies the limit for the given group. Can be changed while the VM is running. The default unit is megabytes per second. The unit can be changed by specifying one of the following suffixes: k for kilobits/s, m for megabits/s, g for gigabits/s, K for kilobytes/s, M for megabytes/s, G for gigabytes/s.

Note

The network bandwidth limits apply only to the traffic being sent by virtual machines. The traffic being received by VMs is unlimited.

Note

To remove a bandwidth group it must not be referenced by any disks or adapters in running VM.