модуль vmware.vmware_rest.vcenter_vm_hardware_cpu — обновляет настройки виртуальной машины, связанные с ЦП.

Примечание

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

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

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

УСТАРЕЛО

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

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

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

Требования

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

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

Параметры

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

Примечания

Примечание

Проверено на 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}`

Статус

Этот модуль будет удалён в версии 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_cpu_module.html