vmware_vm_facts - Возвращение основных фактов о гостевой виртуальной машине vSphere
Новое в версии 2.0.
Обзор
- Возвращает основные факты о гостевой виртуальной машине vSphere.
Требования
Ниже перечислены требования к хосту, на котором выполняется данный модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| 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. |
| vm_type (добавлено в 2.5) |
| Если установлено значение vm, то факты собираются только для виртуальных машин.Если установлено значение template, то факты собираются только для шаблонов виртуальных машин.Если установлено значение all, то факты собираются для всех виртуальных машин и шаблонов виртуальных машин. |
Примечания
Примечание
- Тестировалось на vSphere 5.5 и vSphere 6.5
Примеры
- name: Gather all registered virtual machines
vmware_vm_facts:
hostname: esxi_or_vcenter_ip_or_hostname
username: username
password: password
delegate_to: localhost
register: vmfacts
- debug:
var: vmfacts.virtual_machines
- name: Gather only registered virtual machine templates
vmware_vm_facts:
hostname: esxi_or_vcenter_ip_or_hostname
username: username
password: password
vm_type: template
delegate_to: localhost
register: template_facts
- debug:
var: template_facts.virtual_machines
- name: Gather only registered virtual machines
vmware_vm_facts:
hostname: esxi_or_vcenter_ip_or_hostname
username: username
password: password
vm_type: vm
delegate_to: localhost
register: vm_facts
- debug:
var: vm_facts.virtual_machines
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие — это поля, уникальные для данного модуля:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| virtual_machines dict | успешно | словарь виртуальных машин и их фактов |
Статус
Данный модуль помечен как preview, что означает, что он не гарантирует обратную совместимость.
Техническое обслуживание
Данный модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Более подробную информацию см. в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Joseph Callen (@jcpowermac)
- 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_vm_facts_module.html
