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

Примечание

Этот модуль является частью коллекции vmware.vmware_rest (версия 3.2.0).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install vmware.vmware_rest. Для использования этого модуля требуются дополнительные компоненты, см. Требования для получения подробностей.

Чтобы использовать его в книге задач, укажите: vmware.vmware_rest.vcenter_vm_guest_networking_interfaces_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`.
vcenter_rest_log_file строка	Вы можете использовать этот необязательный параметр для указания расположения файла журнала. Этот файл будет использоваться для записи взаимодействия HTTP REST. Файл будет сохранён на хосте, на котором выполняется модуль. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_REST_LOG_FILE`.
vcenter_username строка / обязательно	Имя пользователя vCenter vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_USER`.
vcenter_validate_certs булево	Разрешает подключение, когда сертификаты SSL недействительны. Установите в `false`, когда сертификаты ненадёжные. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
vm строка	Идентификатор виртуальной машины. Параметр должен содержать идентификатор ресурса, возвращённого модулем vmware.vmware_rest.vcenter_vm_info. Требуется при state=[‘list’]

Примечания

Примечание

Проверено на 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: Get guest network interfaces information
  vmware.vmware_rest.vcenter_vm_guest_networking_interfaces_info:
    vm: '{{ test_vm1_info.id }}'
  register: _result

Возвращаемые значения

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

Ключ	Описание
value список / элементы=строка	Получение информации о сетевых интерфейсах гостевой ОС Возвращаемое: При успехе Пример: `[{"ip": {"ip_addresses": []}, "mac_address": "00:50:56:b1:33:76", "nic": "4000"}]`

Авторы

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