vmware.vmware_rest.vcenter_vm_hardware_adapter_scsi модуль — Добавляет виртуальный адаптер SCSI к виртуальной машине.

Примечание

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

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

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

Чтобы использовать его в книге задач, укажите: vmware.vmware_rest.vcenter_vm_hardware_adapter_scsi.

Новая в vmware.vmware_rest 0.1.0

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

Описание

Добавляет виртуальный адаптер SCSI к виртуальной машине.

Требования

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

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

Параметры

Параметр	Комментарии
adapter строка	Идентификатор виртуального адаптера SCSI. Параметр должен быть идентификатором ресурса, возвращаемого vmware.vmware_rest.vcenter_vm_hardware_adapter_scsi. Требуется со значением state=[‘отсутствует’, ‘присутствует’]
bus целое число	Номер шины SCSI. Если не задан, сервер выберет доступный номер шины; если таковой не будет доступен, запрос завершится ошибкой. По умолчанию: `0`
label строка	Имя элемента
pci_slot_number целое число	Адрес адаптера SCSI на шине PCI. Если адрес PCI недействителен, сервер изменит его при запуске ВМ или при динамическом добавлении устройства. Если не задан, сервер выберет доступный адрес при включении виртуальной машины.
session_timeout число с плавающей точкой добавлено в vmware.vmware_rest 2.1.0	Настройки тайм-аута сеанса клиента. Максимальное количество секунд для всей операции, включая установку соединения, отправку запроса и получение ответа. Значение по умолчанию — 300 секунд.
sharing строка	Перечисление sharing определяет допустимые режимы совместного использования шины для виртуального адаптера SCSI. Доступные значения: `"NONE"` `"PHYSICAL"` `"VIRTUAL"`
state строка	Доступные значения: `"absent"` `"present"` ← (по умолчанию)
type строка	Перечисление type определяет допустимые типы эмуляции для виртуального адаптера SCSI. Доступные значения: `"BUSLOGIC"` `"LSILOGIC"` `"LSILOGICSAS"` `"PVSCSI"`
vcenter_hostname строка / обязательно	Имя хоста или IP-адрес vCenter vSphere Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_HOST`.
vcenter_password строка / обязательно	Пароль vCenter vSphere Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PASSWORD`.
vcenter_rest_log_file строка	Вы можете использовать этот необязательный параметр для указания расположения файла журнала. Этот файл будет использоваться для записи взаимодействия REST HTTP. Файл будет сохранён на хосте, на котором выполняется модуль. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_REST_LOG_FILE`.
vcenter_username строка / обязательно	Имя пользователя vCenter vSphere Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_USER`.
vcenter_validate_certs булево значение	Разрешает подключение при недействительных сертификатах SSL. Установите в `false`, если сертификаты не доверяются. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Доступные значения: `false` `true` ← (по умолчанию)
vm строка / обязательно	Идентификатор виртуальной машины. Параметр должен быть идентификатором ресурса, возвращаемого 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: Create a SCSI adapter at PCI slot 35
  vmware.vmware_rest.vcenter_vm_hardware_adapter_scsi:
    vm: '{{ test_vm1_info.id }}'
    pci_slot_number: 35
  register: _scsi_adapter_result_1

- name: Drop the SCSI controller
  vmware.vmware_rest.vcenter_vm_hardware_adapter_scsi:
    vm: '{{ test_vm1_info.id }}'
    pci_slot_number: 35
    state: absent
  register: _result

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

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

Ключ	Описание
id строка	moid ресурса Возвращается: При успехе Пример: `"1000"`
value словарь	Создаёт адаптер SCSI в слоте PCI 35 Возвращается: При успехе Пример: `{"label": "SCSI controller 0", "pci_slot_number": 35, "scsi": {"bus": 0, "unit": 7}, "sharing": "NONE", "type": "PVSCSI"}`

Авторы

Команда 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_adapter_scsi_module.html