Модуль vmware.vmware_rest.vcenter_vm_hardware_floppy – Добавление виртуального дисковода гибких дисков к виртуальной машине.

Примечание

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

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

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

Для использования в playbook укажите: 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 / required	Имя хоста или IP-адрес vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_HOST`.
vcenter_password string / required	Пароль vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PASSWORD`.
vcenter_rest_log_file string	Этот необязательный параметр можно использовать для указания местоположения файла журнала. Этот файл будет использоваться для записи взаимодействия HTTP REST. Файл будет храниться на хосте, на котором выполняется модуль. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_REST_LOG_FILE`.
vcenter_username string / required	Имя пользователя vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_USER`.
vcenter_validate_certs boolean	Разрешает подключение, когда SSL-сертификаты недействительны. Установите в `false`, когда сертификаты не являются доверенными. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
vm string / required	Идентификатор виртуальной машины. Параметр должен быть идентификатором ресурса, возвращаемого 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 строка	moid ресурса Возвращается: При успехе Пример: `"8000"`
значение словарь	Добавить дисковод гибких дисков Возвращается: При успехе Пример: `{"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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/vmware/vmware_rest/vcenter_vm_hardware_floppy_module.html