community.vmware.vmware_dvswitch_nioc – Управление контролем сетевого ввода-вывода распределённого коммутатора
Примечание
Этот плагин входит в коллекцию community.vmware (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install community.vmware
Для использования в плейбуке укажите: community.vmware.vmware_dvswitch_nioc
Описание
- Этот модуль может использоваться для управления конфигурациями распределённого коммутатора Network IO Control.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| hostname строка | Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды VMWARE_HOSTПоддержка переменных среды добавлена в Ansible 2.6. | ||
| password строка | Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды VMWARE_PASSWORDПоддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd | ||
| port целое число | Значение по умолчанию: 443 | Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды VMWARE_PORTПоддержка переменных среды добавлена в Ansible 2.6. | |
| proxy_host строка | Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Формат - имя хоста или IP-адрес. Если значение не указано в задаче, используется значение переменной среды VMWARE_PROXY_HOSTЭта функция зависит от версии pyvmomi, большей, чем v6.7.1.2018.12 | ||
| proxy_port целое число | Порт HTTP-прокси, который будет получать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, используется значение переменной среды VMWARE_PROXY_PORT | ||
| resources список / элементы=словарь | Список словарей, содержащих. | ||
| limit целое число | Значение по умолчанию: -1 | Максимальное допустимое использование класса трафика, принадлежащего данному пулу ресурсов, на физическом сетевом интерфейсе хоста. | |
| name строка / обязательно |
| Имя ресурса. | |
| reservation целое число | Игнорируется, если версия NIOC установлена в version2 Количество полосы пропускания, гарантированно доступное для класса трафика инфраструктуры хоста. Если использование меньше резервации, дополнительная полоса пропускания используется для других типов классов трафика инфраструктуры хоста. Резервация не может превышать значение лимита, если лимит установлен. Единица измерения - Мбит/с. Игнорируется, если версия не "version3". Количество полосы пропускания, гарантированно доступное для класса трафика инфраструктуры хоста. | ||
| shares целое число | Количество выделенных долей. Игнорируется, если shares_level равно "custom". | ||
| shares_level строка |
| Уровень выделения долей. Уровень - упрощённый вид долей. Уровни сопоставляются с предварительно определённым набором числовых значений для долей. | |
| state строка |
| Включить или отключить NIOC на распределённом коммутаторе. | |
| switch строка / обязательно | Имя распределённого коммутатора. псевдонимы: dvswitch | ||
| username строка | Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды VMWARE_USERПоддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user | ||
| validate_certs логическое значение |
| Разрешает подключение, когда сертификаты SSL недействительны. Устанавливается в false, когда сертификаты не доверяются.Если значение не указано в задаче, используется значение переменной среды VMWARE_VALIDATE_CERTSПоддержка переменных среды добавлена в Ansible 2.6. Если установлено true, убедитесь, что на указанной машине установлен Python >= 2.7.9. | |
| version строка |
| Версия контроля сетевого ввода-вывода. | |
Примечания
Примечание
- Тестировано на vSphere 6.7
Примеры
- name: Enable NIOC
community.vmware.vmware_dvswitch_nioc:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
switch: dvSwitch
version: version3
resources:
- name: vmotion
limit: -1
reservation: 128
shares_level: normal
- name: vsan
limit: -1
shares_level: custom
shares: 99
reservation: 256
state: present
delegate_to: localhost
- name: Disable NIOC
community.vmware.vmware_dvswitch_nioc:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
switch: dvSwitch
state: absent
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны в документации, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| dvswitch_nioc_status строка | success | Результат изменений |
| resources_changed список / элементы=строка | success | Список ресурсов, которые были изменены Пример: ['vmotion', 'vsan'] |
Авторы
- Joseph Andreatta (@vmwjoseph)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/vmware/vmware_dvswitch_nioc_module.html