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

Примечание

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

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

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

Обзор

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

Требования

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

vSphere 7.0.3 или новее
python >= 3.6
aiohttp

Параметры

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