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

Примечание

Этот модуль входит в коллекцию 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_adapter_scsi.

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

УСТАРЕЛ
Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

УСТАРЕЛ

Удалён в:: версии 5.0.0
Причина:: Этот модуль перенесён в новую коллекцию vmware.vmware
Альтернатива:: Вместо него используйте vmware.vmware.vm.

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

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

Требования

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

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

Параметры

Параметр	Комментарии
adapter string	Идентификатор виртуального адаптера SCSI. Параметр должен содержать идентификатор ресурса, возвращённого модулем vmware.vmware_rest.vcenter_vm_hardware_adapter_scsi. Обязателен при state=[‘absent’, ‘present’]
bus integer	Номер шины SCSI. Если значение не задано, сервер выберет доступный номер шины; если доступных номеров нет, запрос завершится ошибкой. По умолчанию: `0`
label string	Название элемента
pci_slot_number integer	Адрес адаптера SCSI на шине PCI. Если адрес PCI недействителен, сервер изменит его при запуске виртуальной машины или при горячем добавлении устройства. Если значение не задано, сервер выберет доступный адрес при включении виртуальной машины.
session_timeout float Добавлен в vmware.vmware_rest 2.1.0	Настройки времени ожидания сеанса клиента. Максимальное количество секунд на выполнение всей операции, включая установление соединения, отправку запроса и получение ответа. Значение по умолчанию — 300 с.
sharing string	Перечислимый тип sharing определяет допустимые режимы совместного использования шины для виртуального адаптера SCSI. Варианты: `"NONE"` `"PHYSICAL"` `"VIRTUAL"`
state string	Варианты: `"absent"` `"present"` ← (по умолчанию)
type string	Перечислимый тип type определяет допустимые типы эмуляции для виртуального адаптера SCSI. Варианты: `"BUSLOGIC"` `"LSILOGIC"` `"LSILOGICSAS"` `"PVSCSI"`
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: 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 string	moid ресурса Возвращается: при успешном выполнении Пример: `"1000"`
value dictionary	Создание адаптера SCSI в слоте PCI 35 Возвращается: при успешном выполнении Пример: `{"label": "SCSI controller 0", "pci_slot_number": 35, "scsi": {"bus": 0, "unit": 7}, "sharing": "NONE", "type": "PVSCSI"}`

Статус

Этот модуль будет удалён в версии 5.0.0. [устарел]
Дополнительные сведения см. в разделе УСТАРЕЛ.

Авторы

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