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

backing

словарь

Существующий физический ресурс, используемый виртуальным диском. Необходимо указать ровно один из параметров backing или new_vmdk.

Если параметр не задан, виртуальный диск не будет подключен к существующему ресурсу. Обязателен при state=[‘present’]

Допустимые атрибуты:

- type (str): Этот параметр задает допустимые типы ресурсов, используемых виртуальным диском. ([‘present’])

Этот ключ обязателен при [‘present’].

- Допустимые значения:

- VMDK_FILE

- vmdk_file (str): Путь к файлу VMDK, используемому виртуальным диском.

Это поле необязательно и имеет значение только тогда, когда значение type равно VMDK_FILE. ([‘present’])

disk

строка

Идентификатор виртуального диска.

Значением параметра должен быть идентификатор ресурса, возвращаемый модулем vmware.vmware_rest.vcenter_vm_hardware_disk. Обязателен при state=[‘absent’, ‘present’]

ide

словарь

Адрес для подключения устройства к виртуальному адаптеру IDE.

Если параметр не задан, сервер выберет доступный адрес; если доступных адресов нет, запрос завершится ошибкой.

Допустимые атрибуты:

- primary (bool): Флаг, указывающий, следует ли подключить устройство к первичному или вторичному адаптеру IDE виртуальной машины.

Если параметр не задан, сервер выберет адаптер со свободным подключением. Если свободных подключений IDE нет, запрос будет отклонен. ([‘present’])

- master (bool): Флаг, указывающий, должно ли устройство быть ведущим или ведомым устройством адаптера IDE.

Если параметр не задан, сервер выберет доступный тип подключения. Если свободных подключений IDE нет, запрос будет отклонен. ([‘present’])

label

строка

Имя элемента

new_vmdk

словарь

Параметры создания нового ресурса VMDK для виртуального диска. Необходимо указать ровно один из параметров backing или new_vmdk.

Если параметр не задан, новый ресурс VMDK создан не будет.

Допустимые атрибуты:

- name (str): Базовое имя файла VMDK. Имя не должно содержать расширение файла «.vmdk».

Если параметр не задан, сервер выберет имя на основе имени виртуальной машины. ([‘present’])

- capacity (int): Емкость виртуального диска в байтах.

Если параметр не задан, используется емкость, заданная по умолчанию для гостевой системы. ([‘present’])

- storage_policy (dict): Структура storage_policy_spec содержит сведения о политике хранения, которая будет связана с файлом VMDK.

Если параметр не задан, применяется политика хранения по умолчанию для целевого хранилища данных (если применимо). В настоящее время политика хранения по умолчанию поддерживается только объектными хранилищами данных: VVol и vSAN. Для необъектных хранилищ данных, если параметр не задан, с файлом VMDK не будет связана политика хранения. ([‘present’])

- Допустимые ключи:

- policy (string): Идентификатор политики хранения, которая должна быть связана с файлом VMDK.

При передаче клиентами значения этой структуры в качестве параметра поле должно содержать идентификатор ресурса, возвращаемый модулем vmware.vmware_rest.vcenter_storage_policies_info.

nvme

словарь

Адрес для подключения устройства к виртуальному адаптеру NVMe.

Если параметр не задан, сервер выберет доступный адрес; если доступных адресов нет, запрос завершится ошибкой. Обязателен при state=[‘present’]

Допустимые атрибуты:

- bus (int): Номер шины адаптера, к которому следует подключить устройство. ([‘present’])

Этот ключ обязателен при [‘present’].

- unit (int): Номер устройства.

Если параметр не задан, сервер выберет доступный номер устройства на указанном адаптере. Если на адаптере нет свободных подключений, запрос будет отклонен. ([‘present’])

sata

словарь

Адрес для подключения устройства к виртуальному адаптеру SATA.

Если параметр не задан, сервер выберет доступный адрес; если доступных адресов нет, запрос завершится ошибкой. Обязателен при state=[‘present’]

Допустимые атрибуты:

- bus (int): Номер шины адаптера, к которому следует подключить устройство. ([‘present’])

Этот ключ обязателен при [‘present’].

- unit (int): Номер устройства.

Если параметр не задан, сервер выберет доступный номер устройства на указанном адаптере. Если на адаптере нет свободных подключений, запрос будет отклонен. ([‘present’])

scsi

словарь

Адрес для подключения устройства к виртуальному адаптеру SCSI.

Если параметр не задан, сервер выберет доступный адрес; если доступных адресов нет, запрос завершится ошибкой. Обязателен при state=[‘present’]

Допустимые атрибуты:

- bus (int): Номер шины адаптера, к которому следует подключить устройство. ([‘present’])

Этот ключ обязателен при [‘present’].

- unit (int): Номер устройства.

Если параметр не задан, сервер выберет доступный номер устройства на указанном адаптере. Если на адаптере нет свободных подключений, запрос будет отклонен. ([‘present’])

session_timeout

число с плавающей точкой

добавлено в vmware.vmware_rest 2.1.0

Настройки времени ожидания для сеанса клиента.

Максимальное количество секунд для всей операции, включая установление соединения, отправку запроса и получение ответа.

Значение по умолчанию — 300 с.

state

строка

Варианты:

• "absent"
• "present" ← (по умолчанию)

type

строка

Перечисление host_bus_adapter_type определяет допустимые типы адаптеров шины хоста, которые можно использовать для подключения виртуального устройства хранения к виртуальной машине.

Варианты:

• "IDE"
• "NVME"
• "SATA"
• "SCSI"

vcenter_hostname

строка / обязательный

Имя хоста или IP-адрес vSphere vCenter

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_HOST.

vcenter_password

строка / обязательный

Пароль vSphere vCenter

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_PASSWORD.

vcenter_rest_log_file

строка

С помощью этого необязательного параметра можно задать расположение файла журнала.

Этот файл будет использоваться для записи взаимодействия HTTP REST.

Файл будет сохранен на узле, на котором выполняется модуль.

Если значение не указано в задаче, вместо него будет использовано значение

переменной среды VMWARE_REST_LOG_FILE.

vcenter_username

строка / обязательный

Имя пользователя vSphere vCenter

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_USER.

vcenter_validate_certs

логическое значение

Разрешает подключение при недействительных сертификатах SSL. Если сертификаты не являются доверенными, задайте значение false.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_VALIDATE_CERTS.

Варианты:

• false
• true ← (по умолчанию)

vm

строка / обязательный

Идентификатор виртуальной машины.

Значением параметра должен быть идентификатор ресурса, возвращаемый модулем vmware.vmware_rest.vcenter_vm_info. Этот параметр является обязательным.

id

строка

MOID ресурса

Возвращается: при успешном выполнении

Пример: "16000"

value

словарь

Создание нового диска

Возвращается: при успешном выполнении

Пример: {"backing": {"type": "VMDK_FILE", "vmdk_file": "[local] test_vm1/test_vm1_1.vmdk"}, "capacity": 320000, "label": "Hard disk 2", "sata": {"bus": 0, "unit": 0}, "type": "SATA"}