модуль vmware.vmware_rest.appliance_networking_interfaces_ipv4 — настройка конфигурации сети IPv4 для определённого сетевого интерфейса.

Примечание

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

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

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

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

Настройка конфигурации сети IPv4 для определённого сетевого интерфейса.

Требования

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

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

Параметры

Параметр	Комментарии
address string	Адрес IPv4, например «10.20.80.191». Это поле необязательно и используется только в том случае, если значение mode равно STATIC.
default_gateway string	Адрес IPv4 шлюза по умолчанию. Этот параметр настраивает глобальный шлюз по умолчанию на устройстве, указывая адрес шлюза и интерфейс. Этот шлюз заменяет существующий шлюз по умолчанию, настроенный на устройстве. Однако если адрес шлюза является локальным для канала, он добавляется для этого интерфейса. Настройка нескольких глобальных шлюзов по умолчанию через разные интерфейсы не поддерживается. Если значение не задано, defaultGateway никогда не задавался.
interface_name string / обязательный	Сетевой интерфейс для обновления, например «nic0». Параметр должен содержать идентификатор ресурса, возвращаемого модулем vmware.vmware_rest.appliance_networking_interfaces_info. Этот параметр обязателен.
mode string / обязательный	Перечисляемый тип mode определяет различные режимы назначения адреса IPv4. Этот параметр обязателен. Варианты: `"DHCP"` `"STATIC"` `"UNCONFIGURED"`
prefix integer	Префикс CIDR IPv4, например 24. Информацию о преобразовании маски подсети в префикс см. по адресу http://www.oav.net/mirrors/cidr.html. Это поле необязательно и используется только в том случае, если значение mode равно STATIC.
session_timeout float добавлено в vmware.vmware_rest 2.1.0	Настройки времени ожидания сеанса клиента. Максимальное количество секунд для всей операции, включая установление соединения, отправку запроса и получение ответа. Значение по умолчанию — 300 с.
state string	Варианты: `"set"` ← (по умолчанию)
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: Set the IPv4 network information of nic99 (which does not exist)
  vmware.vmware_rest.appliance_networking_interfaces_ipv4:
    interface_name: nic99
    config:
      address: 10.20.80.191
      prefix: '32'
      mode: STATIC
  failed_when:
  - not(result.failed)
  - result.value.messages[0].default_message msg == "The interface is unknown."
  register: result

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

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

Ключ	Описание
failed_when_result integer	Задать сетевую информацию IPv4 для nic99 (который не существует) Возвращается: При успехе Пример: `0`
msg string	Задать сетевую информацию IPv4 для nic99 (который не существует) Возвращается: При успехе Пример: `"missing required arguments: mode"`

Авторы

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