community.vmware.vmware_host_vmnic_info – Сбор информации о доступных vmnics на данном хосте ESXi

Примечание

Этот плагин является частью коллекции community.vmware (версия 1.7.0).

Для его установки используйте: ansible-galaxy collection install community.vmware.

Для использования в playbook, укажите: community.vmware.vmware_host_vmnic_info.

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

Обзор

Этот модуль может быть использован для сбора информации о доступных vmnics на заданном хосте ESXi.
Если cluster_name указан, то информация о vmnics всех хостов из заданного кластера будет возвращена.
Если esxi_hostname указан, то информация о vmnics заданной системы хоста будет возвращена.
Дополнительные данные о vswitch и dvswitch с соответствующими vmnics также предоставляются, что добавлено в версии 2.7.

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
capabilities boolean	Варианты: нет ← да	Сбор информации о общих возможностях (Автопереговоры, Wake On LAN и Управление сетевым вводом-выводом).
cluster_name string		Имя кластера, из которого будут использоваться все хосты. Информация о vmnics каждого сервера ESXi будет возвращена для данного кластера. Этот параметр требуется, если `esxi_hostname` не указан.
directpath_io boolean	Варианты: нет ← да	Сбор информации о возможностях и конфигурации DirectPath I/O.
esxi_hostname string		Имя системы хоста для работы. Информация о vmnics этого сервера ESXi будет возвращена. Этот параметр требуется, если `cluster_name` не указан.
hostname string		Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в Ansible 2.6.
password string		Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd
port integer	По умолчанию: 443	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в Ansible 2.6.
proxy_host string		Адрес прокси-сервера, который будет получать все запросы HTTPS и пересылать их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_HOST`. Эта функция зависит от версии pyvmomi, большей чем v6.7.1.2018.12
proxy_port integer		Порт HTTP-прокси-сервера, который будет получать все запросы HTTPS и пересылать их. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_PORT`.
sriov boolean	Варианты: нет ← да	Сбор информации о возможностях и конфигурации SR-IOV.
username string		Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs boolean	Варианты: нет да ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите в `false` при недоверенных сертификатах. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено в `true`, убедитесь, что Python >= 2.7.9 установлен на данном компьютере.

Примечания

Примечание

Тестировано на vSphere 6.5

Примеры

- name: Gather info about vmnics of all ESXi Host in the given Cluster
  community.vmware.vmware_host_vmnic_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    cluster_name: '{{ cluster_name }}'
  delegate_to: localhost
  register: cluster_host_vmnics

- name: Gather info about vmnics of an ESXi Host
  community.vmware.vmware_host_vmnic_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
  delegate_to: localhost
  register: host_vmnics

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие являются полями, уникальными для данного модуля:

Ключ	Возвращаемое значение	Описание
hosts_vmnics_info dictionary	hosts_vmnics_info	Словарь с именем хоста в качестве ключа и словарем с информацией о vmnics в качестве значения. для `num_vmnics`, считаются только сетевые адаптеры, начинающиеся с vmnic. Сетевые адаптеры, такие как vusb, не считаются. Подробности о vswitch и dvswitch были добавлены в версии 2.7. Подробности о vmnics были добавлены в версии 2.8. Пример:* {'10.76.33.204': {'все': ['vmnic0', 'vmnic1'], 'доступные': [], 'dvswitch': {'dvs_0002': ['vmnic1']}, 'количество_vmnics': 2, 'используемые': ['vmnic1', 'vmnic0'], 'vmnic_details': [{'действительный_дуплекс': 'Полный дуплекс', 'действительная_скорость': 10000, 'адаптер': 'Intel(R) 82599 10 Gigabit Dual Port Network Connection', 'конфигурированный_дуплекс': 'Автопереговоры', 'конфигурированная_скорость': 'Автопереговоры', 'устройство': 'vmnic0', 'драйвер': 'ixgbe', 'местоположение': '0000:01:00.0', 'mac': 'aa:bb:cc:dd:ee:ff', 'состояние': 'Подключено'}, {'действительный_дуплекс': 'Полный дуплекс', 'действительная_скорость': 10000, 'адаптер': 'Intel(R) 82599 10 Gigabit Dual Port Network Connection', 'конфигурированный_дуплекс': 'Автопереговоры', 'конфигурированная_скорость': 'Автопереговоры', 'устройство': 'vmnic1', 'драйвер': 'ixgbe', 'местоположение': '0000:01:00.1', 'mac': 'ab:ba:cc:dd:ee:ff', 'состояние': 'Подключено'}], 'vswitch': {'vSwitch0': ['vmnic0']}}}

Авторы

Abhijeet Kasurde (@Akasurde)
Christian Kotte (@ckotte)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/vmware/vmware_host_vmnic_info_module.html