Модуль vmware.vmware_rest.appliance_networking_interfaces_info — получение информации о конкретном сетевом интерфейсе.

Примечание

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

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

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

Чтобы использовать модуль в сценарии, укажите: 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 / обязательный	Имя хоста или 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` ← (по умолчанию)

Примечания

Примечание

Проверено на 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/vmware/vmware_rest/appliance_networking_interfaces_info_module.html