community.vmware.vmware_guest_vgpu модуль — Изменение профиля видеокарты vGPU указанной виртуальной машины в заданной инфраструктуре vCenter

Примечание

Этот модуль является частью коллекции community.vmware (версия 4.7.1).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.vmware.

Для использования в playbook укажите: community.vmware.vmware_guest_vgpu.

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

Описание

Этот модуль используется для переконфигурации профиля видеокарты vGPU заданной виртуальной машины.
Виртуальная машина должна быть выключена. Модуль community.vmware.vmware_guest_powerstate может выполнить эту задачу.

Параметры

Параметр	Комментарии
cluster string	Имя кластера, где работает виртуальная машина.
datacenter string	Имя центра обработки данных, к которому принадлежит виртуальная машина. Default: `"ha-datacenter"`
esxi_hostname string	Имя хоста ESXi, где работает виртуальная машина.
folder string	Папка назначения, абсолютный или относительный путь для поиска существующего гостя. Это обязательный параметр, только если найдено несколько виртуальных машин с одинаковым именем. Папка должна включать центр обработки данных. Центр обработки данных сервера 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
force boolean	Принудительная операция. Choices: `false` ← (default) `true`
hostname string	Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_HOST`.
moid string	Идентификатор управляемого объекта экземпляра для управления, если известен; это уникальный идентификатор только в одном экземпляре vCenter. Это необходимо, если `name` или `uuid` не указаны.
name string	Имя виртуальной машины. Это обязательный параметр, если параметр `uuid` или `moid` не указан.
password aliases: pass, pwd string	Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_PASSWORD`.
port integer	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_PORT`. Default: `443`
proxy_host string	Адрес прокси-сервера, который будет получать все запросы HTTPS и пересылать их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_PROXY_HOST`.
proxy_port integer	Порт HTTP-прокси, который будет получать все запросы HTTPS и пересылать их. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_PROXY_PORT`.
state string	Состояние профиля vGPU. Когда `present`, выбранный профиль vGPU будет добавлен, если хост ESXi, на котором размещена виртуальная машина, предлагает его на графическом процессоре NVIDIA. Когда `absent`, выбранный профиль vGPU будет удален из виртуальной машины. Choices: `"present"` ← (default) `"absent"`
use_instance_uuid boolean	Использовать ли VMware instance UUID вместо BIOS UUID. Choices: `false` ← (default) `true`
username aliases: admin, user string	Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_USER`.
uuid string	UUID экземпляра для сбора фактов, если известен; это уникальный идентификатор VMware. Это обязательный параметр, если параметр `name` или `moid` не указан.
validate_certs boolean	Разрешает подключение, когда SSL-сертификаты недействительны. Установите значение `false`, если сертификаты не являются доверенными. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_VALIDATE_CERTS`. Choices: `false` `true` ← (default)

vgpu

string

Поддерживаемый профиль vGPU в зависимости от модели GPU. Требуется для любой операции.

Примечания

Примечание

Все модули требуют доступа для записи в API и поэтому не поддерживаются с бесплатной лицензией ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.

Примеры

- name: Add vGPU profile to VM
  community.vmware.vmware_guest_vgpu:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    validate_certs: false
    name: UbuntuTest
    vgpu: 'grid_m10-8q'
    state: present
  delegate_to: localhost
  register: vgpu_info

- name: Remove vGPU profile to VM
  community.vmware.vmware_guest_vgpu:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    validate_certs: false
    name: UbuntuTest
    vgpu: 'grid_m10-8q'
    state: absent
  delegate_to: localhost
  register: vgpu_info

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

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

Ключ	Описание
vgpu_info словарь	Метаданные о профиле vGPU виртуальной машины Возвращается: всегда Пример: `{"vgpu": {"Controller_Key": 100, "Key": 13000, "Label": "PCI device 0", "Summary": "NVIDIA GRID vGPU grid_m10-8q", "Unit_Number": 18, "Vgpu": "grid_m10-8q"}}`

Авторы

Mohamed Alibi (@Medalibi)
Неизвестно (@matancarmeli7)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/vmware/vmware_guest_vgpu_module.html