Модуль vmware.vmware_rest.vcenter_vm_guest_power_info — Возвращает информацию о состоянии питания гостевой операционной системы.

Примечание

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

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

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

Обзор

Возвращает информацию о состоянии питания гостевой операционной системы.

Требования

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

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

Параметры

Параметр	Комментарии
session_timeout float добавлено в vmware.vmware_rest 2.1.0	Настройки таймаута для сессии клиента. Максимальное количество секунд для всей операции, включая установление соединения, отправку запроса и получение ответа. Значение по умолчанию — 300 секунд.
vcenter_hostname строка / обязательно	Имя хоста или IP-адрес vCenter vSphere. Если значение не указано в задаче, используется значение переменной среды `VMWARE_HOST`.
vcenter_password строка / обязательно	Пароль vCenter vSphere. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PASSWORD`.
...	...

Примечания

Примечание

Тестировалось на vSphere 7.0.3

Примеры

- name: Create a VM
  vmware.vmware_rest.vcenter_vm:
    placement:
      cluster: "{{ lookup('vmware.vmware_rest.cluster_moid', '/my_dc/host/my_cluster') }}"
      datastore: "{{ lookup('vmware.vmware_rest.datastore_moid', '/my_dc/datastore/local') }}"
      folder: "{{ lookup('vmware.vmware_rest.folder_moid', '/my_dc/vm') }}"
      resource_pool: "{{ lookup('vmware.vmware_rest.resource_pool_moid', '/my_dc/host/my_cluster/Resources') }}"
    name: test_vm1
    guest_OS: RHEL_7_64
    hardware_version: VMX_11
    memory:
      hot_add_enabled: true
      size_MiB: 1024
    disks:
    - type: SATA
      backing:
        type: VMDK_FILE
        vmdk_file: '[local] test_vm1/{{ disk_name }}.vmdk'
    - type: SATA
      new_vmdk:
        name: second_disk
        capacity: 32000000000
    cdroms:
    - type: SATA
      sata:
        bus: 0
        unit: 2
    nics:
    - backing:
        type: STANDARD_PORTGROUP
        network: "{{ lookup('vmware.vmware_rest.network_moid', '/my_dc/network/VM Network') }}"
  register: my_vm

- name: Read the power status of the VM
  vmware.vmware_rest.vcenter_vm_guest_power_info:
    vm: '{{ my_vm.id }}'

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

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

Ключ	Описание
value словарь	Чтение состояния питания виртуальной машины. Возвращается: При успешном выполнении Пример: `{"operations_ready": 0, "state": "NOT_RUNNING"}`

Авторы

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