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

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.vmware.

Чтобы использовать её в плейбуке, укажите: community.vmware.vmware_guest_vgpu.

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

Краткое описание

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

Параметры

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

Примечания

Примечание

Для всех модулей требуется доступ к API на запись, поэтому они не поддерживаются бесплатной лицензией ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.
Модули могут использовать библиотеку Python ‘requests’, которая по умолчанию не использует системное хранилище сертификатов. Указать хранилище сертификатов можно с помощью переменной окружения REQUESTS_CA_BUNDLE. Обратите внимание: в некоторых случаях установка этой переменной может привести к игнорированию значения ‘false’ параметра ‘validate_certs’. Пример: ‘export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem’

Примеры

- 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 dictionary	Метаданные о профиле 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/vmware/vmware_guest_vgpu_module.html