модуль vmware.vmware_rest.vcenter_vm_hardware_floppy — добавляет виртуальный дисковод гибких дисков в виртуальную машину.

Примечание

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

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

Для установки используйте: ansible-galaxy collection install vmware.vmware_rest. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в сценарии, укажите: vmware.vmware_rest.vcenter_vm_hardware_floppy.

Добавлено в vmware.vmware_rest 0.1.0

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

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

Добавляет виртуальный дисковод гибких дисков в виртуальную машину.

Требования

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

vSphere 7.0.3 или более поздняя версия
python >= 3.6
aiohttp

Параметры

Параметр	Комментарии
allow_guest_control boolean	Флаг, указывающий, может ли гостевая система подключать и отключать устройство. Если параметр не задан, значение не изменяется. Варианты: `false` `true`
backing dictionary	Физический ресурс, используемый виртуальным дисководом гибких дисков. Если параметр не задан, автоматически обнаруживается подходящее устройство узла. Обязателен при state=[‘present’] Допустимые атрибуты: - `type` (str): Этот параметр определяет допустимые типы ресурсов, используемых виртуальным дисководом гибких дисков. ([‘present’]) Этот ключ обязателен при [‘present’]. - Допустимые значения: - CLIENT_DEVICE - HOST_DEVICE - IMAGE_FILE - `image_file` (str): Путь к файлу образа, который следует использовать в качестве ресурса виртуального дисковода гибких дисков. Это поле необязательное и используется только тогда, когда значение type равно IMAGE_FILE. ([‘present’]) - `host_device` (str): Имя устройства, которое следует использовать в качестве ресурса виртуального дисковода гибких дисков. Если параметр не задан, виртуальный дисковод гибких дисков будет настроен на автоматическое обнаружение подходящего устройства узла. ([‘present’])
floppy string	Идентификатор виртуального дисковода гибких дисков. Параметр должен содержать идентификатор ресурса, возвращаемого модулем vmware.vmware_rest.vcenter_vm_hardware_floppy. Обязателен при state=[‘absent’, ‘connect’, ‘disconnect’, ‘present’]
label string	Имя элемента
session_timeout float добавлено в vmware.vmware_rest 2.1.0	Настройки времени ожидания для клиентского сеанса. Максимальное количество секунд для всей операции, включая установление соединения, отправку запроса и получение ответа. Значение по умолчанию — 300 с.
start_connected boolean	Флаг, указывающий, следует ли подключать виртуальное устройство при каждом включении виртуальной машины. Если параметр не задан, значение не изменяется. Варианты: `false` `true`
state string	Варианты: `"absent"` `"connect"` `"disconnect"` `"present"` ← (по умолчанию)
vcenter_hostname string / обязательный	Имя узла или IP-адрес vSphere vCenter Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_HOST`.
vcenter_password string / обязательный	Пароль vSphere vCenter Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PASSWORD`.
vcenter_rest_log_file string	С помощью этого необязательного параметра можно указать расположение файла журнала. Этот файл будет использоваться для записи взаимодействия по HTTP REST. Файл будет сохранен на узле, на котором выполняется модуль. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_REST_LOG_FILE`.
vcenter_username string / обязательный	Имя пользователя vSphere vCenter Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_USER`.
vcenter_validate_certs boolean	Разрешает подключение, если SSL-сертификаты недействительны. Если сертификаты не являются доверенными, установите значение `false`. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
vm string / обязательный	Идентификатор виртуальной машины. Параметр должен содержать идентификатор ресурса, возвращаемого модулем vmware.vmware_rest.vcenter_vm_info. Этот параметр обязателен.

Примечания

Примечание

Проверено на vSphere 7.0.3

Примеры

- name: Look up the VM called test_vm1 in the inventory
  register: search_result
  vmware.vmware_rest.vcenter_vm_info:
    filter_names:
    - test_vm1

- name: Collect information about a specific VM
  vmware.vmware_rest.vcenter_vm_info:
    vm: '{{ search_result.value[0].vm }}'
  register: test_vm1_info

- name: Add a floppy disk drive
  vmware.vmware_rest.vcenter_vm_hardware_floppy:
    vm: '{{ test_vm1_info.id }}'
    allow_guest_control: true
  register: my_floppy_drive

- name: Remove a floppy drive
  vmware.vmware_rest.vcenter_vm_hardware_floppy:
    vm: '{{ test_vm1_info.id }}'
    floppy: '{{ my_floppy_drive.id }}'
    state: absent
  register: _result

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

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

Ключ	Описание
id string	moid ресурса Возвращается: При успешном выполнении Пример: `"8000"`
value dictionary	Добавление дисковода гибких дисков Возвращается: При успешном выполнении Пример: `{"allow_guest_control": 1, "backing": {"auto_detect": 1, "host_device": "", "type": "HOST_DEVICE"}, "label": "Floppy drive 1", "start_connected": 0, "state": "NOT_CONNECTED"}`

Авторы

Команда Ansible Cloud (@ansible-collections)

Ссылки на коллекцию

© 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/vmware/vmware_rest/vcenter_vm_hardware_floppy_module.html