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

Примечание

Этот модуль является частью коллекции 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_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 / required	Сетевой интерфейс для обновления, например, “nic0”. Параметр должен быть идентификатором ресурса, возвращаемого vmware.vmware_rest.appliance_networking_interfaces_info. Этот параметр является обязательным.
mode string / required	Перечисляемый тип mode определяет различные режимы назначения адресов IPv4. Этот параметр является обязательным. Варианты: `"DHCP"` `"STATIC"` `"UNCONFIGURED"`
prefix integer	Префикс IPv4 CIDR, например, 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 / 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: 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 целое число	Устанавливает информацию о сети IPv4 для интерфейса nic99 (который не существует) Возвращается: При успешном выполнении Пример: `0`
msg строка	Устанавливает информацию о сети IPv4 для интерфейса nic99 (который не существует) Возвращается: При успешном выполнении Пример: `"missing required arguments: mode"`

Авторы

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