community.vmware.vmware_host_vmnic_facts – Сбор фактов о vmnics, доступных на данном хосте ESXi
Примечание
Этот плагин является частью коллекции community.vmware (версия 1.6.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 с соответствующим vmnic также предоставляются, что добавлено в версии 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. | |
| ... | ... | ... |
Примечания
Примечание
- Проверено на 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': {'все': ['vmnic0', 'vmnic1'], 'доступные': [], 'dvswitch': {'dvs_0002': ['vmnic1']}, 'количество_vmnics': 2, 'используемые': ['vmnic1', 'vmnic0'], 'vmnic_details': [{'actual_duplex': 'Полный дуплекс', 'actual_speed': 10000, 'адаптер': 'Intel(R) 82599 10 Gigabit Dual Port Network Connection', 'configured_duplex': 'Автопереговоры', 'configured_speed': 'Автопереговоры', 'устройство': 'vmnic0', 'драйвер': 'ixgbe', 'местоположение': '0000:01:00.0', 'mac': 'aa:bb:cc:dd:ee:ff', 'статус': 'Подключено'}, {'actual_duplex': 'Полный дуплекс', 'actual_speed': 10000, 'адаптер': 'Intel(R) 82599 10 Gigabit Dual Port Network Connection', 'configured_duplex': 'Автопереговоры', 'configured_speed': 'Автопереговоры', 'устройство': 'vmnic1', 'драйвер': 'ixgbe', 'местоположение': '0000:01:00.1', 'mac': 'ab:ba:cc:dd:ee:ff', 'статус': 'Подключено'}], 'vswitch': {'vSwitch0': ['vmnic0']}}} |
Статус
- Этот модуль будет удален в основной версии после 2021-12-01. [устаревший]
- Дополнительную информацию см. в разделе УСТАРЕВШИЙ.
Авторы
- 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_facts_module.html