Модуль vmware.vmware_rest.appliance_networking_interfaces_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.appliance_networking_interfaces_info.

Новое в vmware.vmware_rest 2.0.0

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

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

Получение информации о конкретном сетевом интерфейсе.

Требования

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

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

Параметры

Параметр	Комментарии
interface_name string	Сетевой интерфейс, например, “nic0”. Параметр должен быть идентификатором ресурса, возвращаемого функцией vmware.vmware_rest.appliance_networking_interfaces_info. Требуется при state=[‘get’]
session_timeout float добавлено в vmware.vmware_rest 2.1.0	Настройки таймаута для клиентской сессии. Максимальное количество секунд для всей операции, включая установление соединения, отправку запроса и получение ответа. Значение по умолчанию — 300 с.
vcenter_hostname string / required	Имя хоста или IP-адрес vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_HOST`.
vcenter_password string / required	Пароль vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_PASSWORD`.
vcenter_rest_log_file string	Этот необязательный параметр можно использовать для указания местоположения файла журнала. Этот файл будет использоваться для записи взаимодействия HTTP REST. Файл будет храниться на хосте, на котором выполняется модуль. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_REST_LOG_FILE`.
vcenter_username string / required	Имя пользователя vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_USER`.
vcenter_validate_certs boolean	Разрешает подключение, когда сертификаты SSL недействительны. Установите значение `false`, когда сертификаты не являются доверенными. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Get a list of the network interfaces
  vmware.vmware_rest.appliance_networking_interfaces_info:
  register: result

- name: Get details about one network interfaces
  vmware.vmware_rest.appliance_networking_interfaces_info:
    interface_name: nic0
  register: result

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

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

Ключ	Описание
id string	moid ресурса Возвращается: При успехе Пример: `"nic0"`
value dictionary	Получение подробной информации об одном сетевом интерфейсе Возвращается: При успехе Пример: `{"ipv4": {"address": "192.168.123.8", "configurable": 1, "default_gateway": "192.168.123.1", "mode": "STATIC", "prefix": 24}, "ipv6": {"addresses": [{"address": "fe80::5054:ff:fe70:4823", "origin": "OTHER", "prefix": 64, "status": "PREFERRED"}], "autoconf": 1, "configurable": 1, "default_gateway": "", "dhcp": 0}, "mac": "52:54:00:70:48:23", "name": "nic0", "status": "up"}`

Ключ

Описание

string

moid ресурса

Возвращается: При успехе

Пример: "nic0"

value

dictionary

Получение подробной информации об одном сетевом интерфейсе

Возвращается: При успехе

Пример: {"ipv4": {"address": "192.168.123.8", "configurable": 1, "default_gateway": "192.168.123.1", "mode": "STATIC", "prefix": 24}, "ipv6": {"addresses": [{"address": "fe80::5054:ff:fe70:4823", "origin": "OTHER", "prefix": 64, "status": "PREFERRED"}], "autoconf": 1, "configurable": 1, "default_gateway": "", "dhcp": 0}, "mac": "52:54:00:70:48:23", "name": "nic0", "status": "up"}

Авторы

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