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

Примечание

Этот плагин входит в коллекцию community.vmware (версия 1.6.0).

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

Чтобы использовать его в playbook, укажите: community.vmware.vmware_host_vmnic_info.

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

Обзор

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

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
capabilities boolean	Варианты: no ← yes	Сбор информации о общих возможностях (Автопереговоры, Wake On LAN и Управление сетевым вводом-выводом).
cluster_name string		Имя кластера, из которого будут использоваться все хосты. Информация о vmnic каждого сервера ESXi будет возвращена для указанного кластера. Этот параметр требуется, если `esxi_hostname` не указан.
directpath_io boolean	Варианты: no ← yes	Сбор информации о возможностях и конфигурации DirectPath I/O.
esxi_hostname string		Имя хост-системы для работы. Информация о vmnic этого сервера ESXi будет возвращена. Этот параметр требуется, если `cluster_name` не указан.
hostname string		Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задании, вместо него используется значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в Ansible 2.6.
password string		Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задании, вместо него используется значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd
port integer	Значение по умолчанию: 443	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задании, вместо него используется значение переменной среды `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	Варианты: no ← yes	Сбор информации о возможностях и конфигурации SR-IOV.
username string		Имя пользователя сервера vCenter или ESXi. Если значение не указано в задании, вместо него используется значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs boolean	Варианты: no yes ←	Позволяет подключиться, когда сертификаты 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/vmware/vmware_host_vmnic_info_module.html