Модуль vmware.vmware_rest.vcenter_vm_hardware_cpu – Обновляет параметры ЦП виртуальной машины.

Примечание

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

Новое в vmware.vmware_rest 0.1.0

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

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

Обновляет параметры ЦП виртуальной машины.

Требования

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

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

Параметры

Параметр	Комментарии
cores_per_socket integer	Новое количество ядер ЦП на сокет. Количество ядер ЦП в виртуальной машине должно быть кратно количеству ядер на сокет. Если не указано, значение не изменяется.
count integer	Новое количество ядер ЦП. Количество ядер ЦП в виртуальной машине должно быть кратно количеству ядер на сокет. Поддерживаемый диапазон количества ядер ЦП ограничен настроенной гостевой операционной системой и версией виртуального оборудования виртуальной машины. Если виртуальная машина работает, количество ядер ЦП можно увеличить только если hot_add_enabled равно true, и уменьшить только если hot_remove_enabled равно true. Если не указано, значение не изменяется.
hot_add_enabled boolean	Флаг, указывающий, разрешено ли добавление ЦП во время работы виртуальной машины. Это поле можно изменить только если виртуальная машина выключена. Если не указано, значение не изменяется. Варианты: `false` `true`
hot_remove_enabled boolean	Флаг, указывающий, разрешено ли удаление ЦП во время работы виртуальной машины. Это поле можно изменить только если виртуальная машина выключена. Если не указано, значение не изменяется. Варианты: `false` `true`
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. Этот параметр обязателен.

Примечания

Примечание

Проверено на 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: Dedicate one core to the VM
  vmware.vmware_rest.vcenter_vm_hardware_cpu:
    vm: '{{ test_vm1_info.id }}'
    count: 1
  register: _result

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

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

Ключ	Описание
id словарь	moid ресурса Возвращается: При успехе
value словарь	Назначает один ядро процессора для ВМ Возвращается: При успехе Пример: `{"cores_per_socket": 1, "count": 1, "hot_add_enabled": 0, "hot_remove_enabled": 0}`

Авторы

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