community.vmware.vmware_host_vmnic_facts – Сбор фактов о доступных vmnics на данном хосте ESXi

Примечание

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

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

Для использования в плейбуке укажите: community.vmware.vmware_host_vmnic_facts.

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

УСТЕРЕЛО

Удалено в: главной версии после 2021-12-01
Почему: Устарело в пользу модуля community.vmware.vmware_host_vmnic_info.
Альтернатива: Используйте модуль 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	Варианты: no ← yes	Сбор фактов о общих возможностях (автопереговоры, Wake On LAN и контроль сетевого ввода-вывода).
cluster_name string		Имя кластера, из которого будут использоваться все системы хостов. Факты о vmnics каждого сервера ESXi будут возвращены для указанного кластера. Этот параметр необходим, если `esxi_hostname` не указан.
directpath_io boolean	Варианты: no ← yes	Сбор фактов о возможностях и конфигурации DirectPath I/O.
esxi_hostname string		Имя системы хоста для работы. Будут возвращены факты о vmnics этого сервера ESXi. Этот параметр необходим, если `cluster_name` не указан.
hostname string		Имя хоста или IP-адрес сервера vCenter vSphere или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в Ansible 2.6.
password string		Пароль сервера vCenter vSphere или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd
port integer	По умолчанию: 443	Номер порта сервера vCenter vSphere или 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	Варианты: no ← yes	Сбор фактов о возможностях и конфигурации SR-IOV.
username string		Имя пользователя сервера vCenter vSphere или 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 facts about vmnics of all ESXi Host in the given Cluster
  community.vmware.vmware_host_vmnic_facts:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    cluster_name: '{{ cluster_name }}'
  delegate_to: localhost
  register: cluster_host_vmnics

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

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

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

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

Статус

Этот модуль будет удален в следующей версии после 2021-12-01. [устарело]
Для получения дополнительной информации см. УСТЕРЕЛО.

Авторы

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_facts_module.html