# VBoxManage bandwidthctl

VBoxManage-bandwidthctl

1

VBoxManage-bandwidthctl

управление группами полосы пропускания

&product-name;

          VBoxManage bandwidthctl

            uuid
            имя-ВМ

          add
          имя-группы-полосы-пропускания
          --limit=лимит-полосы-пропускания[k|m|g|K|M|G]
          --type=disk|network

          VBoxManage bandwidthctl

            uuid
            имя-ВМ

          list
          --machinereadable

          VBoxManage bandwidthctl

            uuid
            имя-ВМ

          remove
          имя-группы-полосы-пропускания

          VBoxManage bandwidthctl

            uuid
            имя-ВМ

          set
          имя-группы-полосы-пропускания
          --limit=лимит-полосы-пропускания[k|m|g|K|M|G]

## Описание

Команда `VBoxManage bandwidthctl` позволяет управлять группами полосы пропускания для виртуальных машин (ВМ). Группа полосы пропускания указывает лимит полосы пропускания для дисков или сетевых адаптеров ВМ.

Обратите внимание, что лимит полосы пропускания сети применяется только к исходящему траффику ВМ. Входящий траффик не ограничивается.

### Создание группы полосы пропускания

Команда `VBoxManage bandwidthctl add` создает группу полосы пропускания для указанной ВМ. Вы должны указать назначение группы полосы пропускания: для дисков или сетей, а также указать лимит полосы пропускания.

`uuid` | `имя-ВМ`

- Указывает Универсальный Уникальный Идентификатор (UUID) или имя ВМ.

``имя-группы-полосы-пропускания``

- Указывает имя группы полосы пропускания.

`--type=disk|network`

- Указывает тип группы полосы пропускания: `disk` и `network`. Для дополнительной информации смотрите storage-bandwidth-limit или network_bandwidth_limit.

`--limit=`лимит-полосы-пропускания`[k|m|g|K|M|G]`

- Указывает лимит для группы полосы пропускания. По умолчанию, указывается в мегабайтах в секунду. Можно изменить это значение пока ВМ работает.

  Можно изменить единицы измерения, добавляя следующие спецификаторы к лимиту полосы пропускания:

  - `k` – килобит в секунду

  - `m` – мегабит в секунду

  - `g` – гигабит в секунду

  - `K` – килобайт в секунду

  - `M` – мегабайт в секунду

  - `G` – гигабайт в секунду

### Отображение групп полосы пропускания

Команда `VBoxManage bandwidthctl list` показывает все группы полосы пропускания, определенные для указанной ВМ. Используйте опцию `--machinereadable` для вывода в машино-читаемом формате, который использует пары имя-значение.

`uuid` | `имя-ВМ`

- Указывает UUID или имя ВМ.

`--machinereadable`

- Выводит информацию о группах полосы пропускания в виде пар имя-значение.

### Удаление группы полосы пропускания

Команда `VBoxManage bandwidthctl remove` удаляет группу полосы пропускания.

Для успешного удаления группы полосы пропускания, убедитесь что она не ссылается на диск или адаптер работающей ВМ.

`uuid` | `имя-ВМ`

- Указывает UUID или имя ВМ.

``имя-группы-полосы-пропускания``

- Указывает имя группы полосы пропускания.

### Изменение лимита группы полосы пропускания

Команда `VBoxManage bandwidthctl set` изменяет лимит группы полосы пропускания.

`uuid` | `имя-ВМ`

- Указывает UUID или имя ВМ.

``bandwidth-group-name``

- Указывает имя группы полосы пропускания.

`--limit=`лимит-полосы-пропускания`[k|m|g|K|M|G]`

- Указывает лимит для группы полосы пропускания. По умолчанию, указывается в мегабайтах в секунду. Можно изменить это значение пока ВМ работает.

  Можно изменить единицы измерения, добавляя следующие спецификаторы к лимиту полосы пропускания:

  - `k` – килобит в секунду

  - `m` – мегабит в секунду

  - `g` – гигабит в секунду

  - `K` – килобайт в секунду

  - `M` – мегабайт в секунду

  - `G` – гигабайт в секунду

## Примеры

Следующий пример показывает, как использовать команду `VBoxManage bandwidthctl` для создания группы полосы пропускания `Limit` с лимитом в 20 Мбит/с. Затем используется команда `VBoxManage modifyvm` для назначения этой группы первому и второму адаптерам ВМ `vm1`.

    $ VBoxManage bandwidthctl "vm1" add Limit --type network --limit 20m
    $ VBoxManage modifyvm "vm1" --nicbandwidthgroup1 Limit
    $ VBoxManage modifyvm "vm1" --nicbandwidthgroup2 Limit

Можно динамически менять лимит группы полосы пропускания пока ВМ работает. Следующий пример показывает как изменить лимит для группы полосы пропускания `Limit` с 20 Мбит/с в 100 кбит/с:

    $ VBoxManage bandwidthctl "vm1" set Limit --limit 100k

Следующая команда отключает ограничения для всех адаптеров в группе полосы пропускания `Limit` путем установки лимита в ноль (`0`):

    $ VBoxManage bandwidthctl "vm1" set Limit --limit 0