vmware_dvswitch_nioc – Управление сетевым вводом-выводом распределённого коммутатора

Новая в версии 2.9.

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Обзор

Этот модуль можно использовать для управления конфигурациями сетевого ввода-вывода распределённого коммутатора.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

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 целое число добавлено в 2.5	Значение по умолчанию: 443	Порт сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в Ansible 2.6.
proxy_host строка добавлено в 2.9		Адрес прокси-сервера, который будет получать все запросы HTTPS и пересылать их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PROXY_HOST`. Эта функция зависит от версии pyvmomi, большей чем v6.7.1.2018.12
proxy_port целое число добавлено в 2.9		Порт HTTP-прокси-сервера, который будет получать все запросы HTTPS и пересылать их. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PROXY_PORT`.
resources список		Список словарей, содержащих { name: Имя ресурса, одно из следующих: "faultTolerance", "hbr", "iSCSI", "management", "nfs", "vdp", "virtualMachine", "vmotion", "vsan" limit: Максимально допустимое использование для класса трафика, принадлежащего этому пулу ресурсов на физическом сетевом интерфейсе хоста. reservation: (Игнорируется, если версия NIOC установлена в version2) Количество пропускной способности ресурсов, гарантированно доступное для класса трафика инфраструктуры хоста. Если использование меньше, чем резервирование, дополнительная пропускная способность используется для других типов классов трафика инфраструктуры хоста. Резервирование не должно превышать значение limit, если оно задано. Единица измерения — Мбит/с. shares_level: Уровень распределения ("low", "normal", "high", "custom"). Уровень — упрощённый просмотр распределения. Уровни сопоставляются с предварительно определёнными наборами числовых значений для распределения. shares: Игнорируется, если shares_level не "custom". Количество распределённых долей. reservation: Игнорируется, если версия "version3". Количество пропускной способности ресурсов, гарантированно доступное для класса трафика инфраструктуры хоста. }
state строка	Варианты: present ← absent	Включить или отключить NIOC на распределённом коммутаторе.
switch строка / обязательно		Имя распределённого коммутатора. псевдонимы: dvswitch
username строка		Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs булево	Варианты: no yes ←	Разрешает подключение, когда сертификаты SSL недействительны. Устанавливается в `false`, когда сертификаты не надёжны. Если значение не указано в задаче, используется значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено `yes`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
version строка	Варианты: version2 version3	Версия управления сетевым вводом-выводом.

Примечания

Примечание

Проверено на vSphere 6.7

Примеры

- name: Enable NIOC
  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
  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']

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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.9/modules/vmware_dvswitch_nioc_module.html