Модуль vmware.vmware_rest.vcenter_vm_storage_policy – Обновляет конфигурацию политики хранения виртуальной машины и/или её связанных виртуальных жестких дисков.

Примечание

Этот модуль является частью коллекции 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_storage_policy.

Новое в vmware.vmware_rest 0.1.0

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

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

Обновляет конфигурацию политики хранения виртуальной машины и/или её связанных виртуальных жестких дисков.

Требования

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

vSphere 7.0.3 или выше
python >= 3.6
aiohttp

Параметры

Параметр	Комментарии
disks dictionary	Политика или политики хранения, которые будут использоваться при переконфигурации дисков виртуальной машины. Если не указано, текущая политика хранения сохраняется. Когда клиенты передают значение этой структуры в качестве параметра, ключ в отображении полей должен быть идентификатором ресурса, возвращаемого vmware.vmware_rest.vcenter_vm_hardware_disk.
session_timeout float добавлено в vmware.vmware_rest 2.1.0	Настройки времени ожидания для сеанса клиента. Максимальное количество секунд для всей операции, включая установление соединения, отправку запроса и получение ответа. Значение по умолчанию — 300 с.
state string	Варианты: `"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. Этот параметр обязателен.
vm_home dictionary / обязательно	Политика хранения, которая будет использоваться при переконфигурации домашнего каталога виртуальной машины. Если не указано, текущая политика хранения сохраняется. Этот параметр обязателен. Допустимые атрибуты: `type` (str): Этот параметр определяет варианты указания политики, которая будет связана с каталогом домашнего каталога виртуальной машины. ([‘present’]) Этот ключ обязателен с [‘present’]. Допустимые значения: USE_DEFAULT_POLICY USE_SPECIFIED_POLICY `policy` (str): Идентификатор политики хранения. Это поле является необязательным и актуально только тогда, когда значение type равно USE_SPECIFIED_POLICY. Когда клиенты передают значение этой структуры в качестве параметра, поле должно быть идентификатором ресурса политики хранения. ([‘present’])

Примечания

Примечание

Тестировалось на 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: Prepare the disk policy dict
  ansible.builtin.set_fact:
    vm_disk_policy: "{{ {} | combine({ my_new_disk.id: {'policy': my_storage_policy.policy, 'type': 'USE_SPECIFIED_POLICY'} }) }}"

- name: Adjust VM storage policy
  vmware.vmware_rest.vcenter_vm_storage_policy:
    vm: '{{ test_vm1_info.id }}'
    vm_home:
      type: USE_DEFAULT_POLICY
    disks: '{{ vm_disk_policy }}'
  register: _result

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

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

Ключ	Описание
id словарь	moid ресурса Возвращается: При успехе
value словарь	Настройка политики хранилища ВМ Возвращается: При успехе Пример: `{}`

Авторы

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