Spec-Zone.ru › Ansible 2.7

vmware_guest_facts – Сбор фактов о виртуальной машине

Новое в версии 2.3.

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

Описание

  • Сбор фактов о виртуальной машине на кластере VMware ESX

Требования

Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.

  • python >= 2.6
  • PyVmomi

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
datacenter
- / обязательно
Целевой центр обработки данных для операции развертывания
folder
-
По умолчанию:
"/vm"
Целевой каталог, абсолютный или относительный путь к существующему гостевому экземпляру.
Требуется, если указано имя.
Каталог должен включать центр обработки данных. Центр обработки данных ESX — ha-datacenter
Примеры:
folder: /ha-datacenter/vm
folder: ha-datacenter/vm
folder: /datacenter1/vm
folder: datacenter1/vm
folder: /datacenter1/vm/folder1
folder: datacenter1/vm/folder1
folder: /folder1/datacenter1/vm
folder: folder1/datacenter1/vm
folder: /folder1/datacenter1/vm/folder2
folder: vm/folder2
folder: folder2
hostname
строка
Имя хоста или IP-адрес сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, используется значение переменной окружения VMWARE_HOST.
Поддержка переменных окружения добавлена в версии 2.6.
name
-
Имя виртуальной машины для работы
Требуется, если не указан UUID.
name_match
-
    Варианты:
  • первый ←
  • последний
Если несколько виртуальных машин соответствуют имени, используется первая или последняя найденная
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.

псевдонимы: admin, user
uuid
-
UUID экземпляра для управления, если известен, это уникальный идентификатор VMware.
Требуется, если не указано имя.
validate_certs
булево
    Варианты:
  • нет
  • да ←
Разрешает подключение, когда сертификаты SSL недействительны. Установите в false, когда сертификаты недоверенны.
Если значение не указано в задаче, используется значение переменной окружения VMWARE_VALIDATE_CERTS.
Поддержка переменных окружения добавлена в версии 2.6.
Если установлено yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9.

Примечания

Примечание

  • Проверено на vSphere 5.5

Примеры

- name: Gather facts from standalone ESXi server having datacenter as 'ha-datacenter'
  vmware_guest_facts:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: ha-datacenter
    validate_certs: no
    uuid: 421e4592-c069-924d-ce20-7e7533fab926
  delegate_to: localhost
  register: facts

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

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

Ключ Возвращаемое значение Описание
instance
словарь
всегда
метаданные о виртуальной машине

Пример:
None


Статус

  • Этот модуль не гарантирует обратную совместимость. [превью]
  • Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

  • Loic Blot (@nerzhul) <loic.blot@unix-experience.fr>

Подсказка

Если вы заметите проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/vmware_guest_facts_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API