vmware_guest_video – Модифицировать конфигурации видеокарты указанной виртуальной машины в заданной инфраструктуре vCenter

Новая версия с 2.8.

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

Описание

Этот модуль используется для переконфигурации настроек видеокарты заданной виртуальной машины.
Все параметры и имена объектов VMware чувствительны к регистру.

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
datacenter строка	Значение по умолчанию: "ha-datacenter"	Имя дата-центра, к которому принадлежит виртуальная машина. Этот параметр чувствителен к регистру.
display_number целое число		Номер дисплея. Допустимое значение от 1 до 10. Максимальный номер дисплея — 4 в vCenter 6.0, 6.5 веб-интерфейсе.
enable_3D булево	Варианты: no yes	Включить 3D для гостевых операционных систем, для которых VMware поддерживает 3D.
folder строка		Папка назначения, абсолютный или относительный путь для поиска существующего гостя. Это обязательный параметр, только если найдено несколько ВМ с одинаковым именем. Папка должна включать дата-центр. Дата-центр сервера ESXi — 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
gather_video_facts булево	Варианты: no ← yes	Если установлено в True, возвращает настройки видеокарты, другие атрибуты игнорируются. Если установлено в False, выполняется переконфигурация и возвращаются настройки видеокарты.
hostname строка		Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в Ansible 2.6.
memory_3D_mb целое число		Значение 3D памяти должно быть степенью двойки и допустимым значением от 32 МБ до 2048 МБ.
moid строка добавлено в 2.9		Идентификатор управляемого объекта экземпляра для управления, если он известен. Это уникальный идентификатор только в рамках одного экземпляра vCenter. Это требуется, если `name` или `uuid` не указаны.
name строка		Имя виртуальной машины. Это обязательный параметр, если параметр `uuid` или `moid` не указан.
password строка		Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число добавлено в 2.5	Значение по умолчанию: 443	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в Ansible 2.6.
proxy_host строка добавлено в 2.9		Адрес прокси-сервера, который будет получать все запросы HTTPS и пересылать их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PROXY_HOST`. Эта функция зависит от версии pyvmomi, большей чем v6.7.1.2018.12
proxy_port целое число добавлено в 2.9		Порт HTTP-прокси, который будет получать все запросы HTTPS и пересылать их. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PROXY_PORT`.
renderer_3D строка	Варианты: automatic software hardware	Если установлено в `automatic`, автоматически выбирает соответствующий вариант (software или hardware) для этой виртуальной машины. Если установлено в `software`, для 3D-расчетов используется обычная обработка ЦП. Если установлено в `hardware`, для более быстрых 3D-расчетов требуется графическое оборудование (GPU).
use_auto_detect булево	Варианты: no yes	Если установлено в True, к гостевой операционной системе применяются общие настройки видео, атрибуты `display_number` и `video_memory_mb` игнорируются. Если установлено в False, количество дисплеев и общий объем видеопамяти будут переконфигурированы с использованием `display_number` и `video_memory_mb`.
username строка		Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user
uuid строка		UUID экземпляра для сбора фактов, если он известен. Это уникальный идентификатор VMware. Этот параметр является обязательным, если параметр `name` или `moid` не указан.
validate_certs булево	Варианты: no yes ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите в `false`, когда сертификаты не доверяются. Если значение не указано в задаче, используется значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено в `yes`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
video_memory_mb вещественное число		Допустимый диапазон общей видеопамяти виртуальной машины составляет от 1,172 МБ до 256 МБ в ESXi 6.7U1, от 1,172 МБ до 128 МБ в ESXi 6.7 и предыдущих версиях. Для конкретной гостевой ОС минимальный и максимальный объемы видеопамяти могут отличаться, будьте внимательны при настройке этого параметра.

Примечания

Примечание

Тестировалось на vSphere 6.0, 6.5 и 6.7

Примеры

- name: Change video card settings of virtual machine
  vmware_guest_video:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    validate_certs: no
    name: test-vm
    gather_video_facts: false
    use_auto_detect: false
    display_number: 2
    video_memory_mb: 8.0
    enable_3D: true
    renderer_3D: automatic
    memory_3D_mb: 512
  delegate_to: localhost
  register: video_facts

- name: Change video card settings of virtual machine using MoID
  vmware_guest_video:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    validate_certs: no
    moid: vm-42
    gather_video_facts: false
    use_auto_detect: false
    display_number: 2
    video_memory_mb: 8.0
    enable_3D: true
    renderer_3D: automatic
    memory_3D_mb: 512
  delegate_to: localhost
  register: video_facts

Значения возврата

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

Ключ	Возвращаемое значение	Описание
video_status словарь	всегда	метаданные о видеокарте виртуальной машины после их управления Пример: {'auto_detect': False, 'display_number': 2, 'enable_3D_support': True, 'memory_3D': 524288, 'renderer_3D': 'automatic', 'video_memory': 8192}

Статус

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

Авторы

Diane Wang (@Tomorrow9) <dianew@vmware.com>

Подсказка

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

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