vmware_host_vmnic_facts - Сбор фактов о доступных vmnics на заданном хосте ESXi
Новое в версии 2.5.
Обзор
- Этот модуль можно использовать для сбора фактов о доступных vmnics на заданном хосте ESXi.
- Если предоставлен
cluster_name, то будут возвращены данные о vmnics всех хостов из заданного кластера. - Если предоставлен
esxi_hostname, то будут возвращены данные о vmnics заданной системы хоста.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cluster_name | Имя кластера. Факты о vmnics каждого сервера ESXi будут возвращены для заданного кластера. Если esxi_hostname не указан, этот параметр обязателен. | |
| esxi_hostname | Имя хоста ESXi. Будут возвращены факты о vmnics этого сервера ESXi. Если cluster_name не указан, этот параметр обязателен. | |
| hostname | Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_HOST. Поддержка переменной среды добавлена в версии 2.6. | |
| password | Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_PASSWORD. Поддержка переменной среды добавлена в версии 2.6. псевдонимы: pass, pwd | |
| port (добавлено в 2.5) | Значение по умолчанию: 443 | Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_PORT. Поддержка переменной среды добавлена в версии 2.6. |
| username | Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_USER. Поддержка переменной среды добавлена в версии 2.6. псевдонимы: user, admin | |
| validate_certs |
True | Разрешает подключение, когда сертификаты SSL недействительны. Установите значение false в случае недоверенных сертификатов.Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_VALIDATE_CERTS. Поддержка переменной среды добавлена в версии 2.6. |
Примечания
Примечание
- Тестировалось на vSphere 6.5
Примеры
- name: Gather facts about vmnics of all ESXi Host in the given Cluster
vmware_host_vmnic_facts:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
cluster_name: cluster_name
register: cluster_host_vmnics
- name: Gather facts about vmnics of an ESXi Host
vmware_host_vmnic_facts:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname: '{{ esxi_hostname }}'
register: host_vmnics
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| hosts_vmnics_facts dict | hosts_vmnics_facts | dict с именем хоста в качестве ключа и dict с фактами vmnics в качестве значения Пример: {'hosts_vmnics_facts': {'localhost.localdomain': {'available': [], 'all': ['vmnic0'], 'used': ['vmnic0']}}} |
Статус
Этот модуль помечен как preview, что означает, что его интерфейс не гарантируется как обратной совместимости.
Автор
- Abhijeet Kasurde (@akasurde)
Подсказка
Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ для улучшения.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/vmware_host_vmnic_facts_module.html
