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 str |
Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_HOST. Поддержка переменных окружения добавлена в версии 2.6. |
|
| password str |
Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD. Поддержка переменных окружения добавлена в версии 2.6. псевдонимы: pass, pwd |
|
| port int (добавлено в 2.5) |
Значение по умолчанию: 443 |
Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PORT. Поддержка переменных окружения добавлена в версии 2.6. |
| username str |
Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_USER. Поддержка переменных окружения добавлена в версии 2.6. псевдонимы: admin, user |
|
| validate_certs bool |
|
Разрешает подключение, когда сертификаты SSL недействительны. Установите значение false при недоверенных сертификатах.Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_VALIDATE_CERTS. Поддержка переменных окружения добавлена в версии 2.6. Если установлено значение yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
Примечания
Примечание
- Проверено на 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': {'all': ['vmnic0'], 'available': [], 'used': ['vmnic0']}}} |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- 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.6/modules/vmware_host_vmnic_facts_module.html
