Модуль vmware.vmware_rest.appliance_networking_firewall_inbound — задание упорядоченного списка правил брандмауэра для разрешения или запрета трафика с одного или нескольких входящих IP-адресов

Примечание

Этот модуль входит в коллекцию 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_firewall_inbound.

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

УСТАРЕЛО
Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

УСТАРЕЛО

Удалено в:: версии 5.0.0
Причина:: Этот модуль перенесён в новую коллекцию vmware.vmware
Альтернатива:: Вместо него используйте vmware.vmware.vcsa_settings.

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

Задание упорядоченного списка правил брандмауэра для разрешения или запрета трафика с одного или нескольких входящих IP-адресов. Существующие правила брандмауэра перезаписываются новым списком правил. Правила трафика обрабатываются по порядку их следования в списке, сверху вниз. Например, список правил может выглядеть следующим образом: AddressPrefixInterface NamePolicy 10.112.0.10*REJECT 10.112.0.10nic0ACCEPT В приведённом выше примере первое правило отбрасывает все пакеты, поступающие с адреса 10.112.0.1 и

Требования

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

vSphere 7.0.3 или новее
python >= 3.6
aiohttp

Параметры

Параметр	Комментарии
rules list / elements=dictionary / обязательный	Список правил брандмауэра на основе адресов. Этот параметр является обязательным. Допустимые атрибуты: - `address` (str): адрес IPv4 или IPv6. ([‘set’]) Этот ключ обязателен при использовании [‘set’]. - `prefix` (int): префикс CIDR, используемый для маскирования адреса. Например, префикс IPv4 со значением 24 игнорирует младшие 8 бит адреса. ([‘set’]) Этот ключ обязателен при использовании [‘set’]. - `policy` (str): перечислимый тип policy, определяющий политики правил брандмауэра. ([‘set’]) Этот ключ обязателен при использовании [‘set’]. - Допустимые значения: - ACCEPT - IGNORE - REJECT - RETURN - `interface_name` (str): интерфейс, к которому применяется это правило. Пустая строка указывает, что правило применяется ко всем интерфейсам. ([‘set’])
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: Ensure the rules parameter is mandatory
  vmware.vmware_rest.appliance_networking_firewall_inbound:
  register: result
  failed_when:
  - not(result.failed)
  - result.msg == 'missing required arguments: rules'

- name: Set a firewall rule
  vmware.vmware_rest.appliance_networking_firewall_inbound:
    rules:
    - address: 1.2.3.4
      prefix: 32
      policy: ACCEPT
  register: result

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

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

Ключ	Описание
failed_when_result integer	Проверка обязательности параметра rules Возвращается: При успешном выполнении Пример: `0`
msg string	Проверка обязательности параметра rules Возвращается: При успешном выполнении Пример: `"missing required arguments: rules"`

Статус

Этот модуль будет удалён в версии 5.0.0. [устарело]
Дополнительные сведения см. в разделе УСТАРЕЛО.

Авторы

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