community.network.fmgr_fwobj_ippool – Позволяет редактировать объекты пула IP-адресов в FortiManager.

Примечание

Этот плагин является частью коллекции community.network (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install community.network.

Для использования в playbook, укажите: community.network.fmgr_fwobj_ippool.

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

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

Позволяет пользователям добавлять/редактировать/удалять объекты пула IP-адресов.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
adom string	Значение по умолчанию: "root"	ADOM, которому должна принадлежать конфигурация.
arp_intf string		Выберите интерфейс из доступных вариантов, который будет отвечать на запросы ARP. (Если пусто, выбирается любой).
arp_reply string	Варианты: disable enable	Включить/отключить ответы на запросы ARP при добавлении пула IP-адресов к политике (по умолчанию = enable). choice \| disable \| Отключить ответ ARP. choice \| enable \| Включить ответ ARP.
associated_interface string		Имя связанного интерфейса.
block_size string		Количество адресов в блоке (от 64 до 4096, по умолчанию = 128).
comments string		Комментарий.
dynamic_mapping string		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМО ЗНАНИЕ FMGR JSON API! Список нескольких дочерних объектов, которые необходимо добавить. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не параметры Ansible, перечисленные ниже. При отправке все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМОИСКЛЮЧАЕМ со своими опциями. Мы ожидаем, что вы знаете, что делаете с этими параметрами списка и используете руководство по JSON API. В СЛУЧАЕ СОМНЕНИЙ, ВМЕСТО ЭТОГО ИСПОЛЬЗУЙТЕ ПОДОПЦИИ НИЖЕ ДЛЯ СОЗДАНИЯ ОБЪЕКТОВ С НЕСКОЛЬКИМИ ЗАДАЧАМИ
dynamic_mapping_arp_intf string		Динамическое отображение клона исходного параметра с суффиксом.
dynamic_mapping_arp_reply string	Варианты: disable enable	Динамическое отображение клона исходного параметра с суффиксом.
dynamic_mapping_associated_interface string		Динамическое отображение клона исходного параметра с суффиксом.
dynamic_mapping_block_size string		Динамическое отображение клона исходного параметра с суффиксом.
dynamic_mapping_comments string		Динамическое отображение клона исходного параметра с суффиксом.
dynamic_mapping_endip string		Динамическое отображение клона исходного параметра с суффиксом.
dynamic_mapping_num_blocks_per_user string		Динамическое отображение клона исходного параметра с суффиксом.
dynamic_mapping_pba_timeout string		Динамическое отображение клона исходного параметра с суффиксом.
dynamic_mapping_permit_any_host string	Варианты: disable enable	Динамическое отображение клона исходного параметра с суффиксом.
dynamic_mapping_source_endip string		Динамическое отображение клона исходного параметра с суффиксом.
dynamic_mapping_source_startip string		Динамическое отображение клона исходного параметра с суффиксом.
dynamic_mapping_startip string		Динамическое отображение клона исходного параметра с суффиксом.
dynamic_mapping_type string	Варианты: overload one-to-one fixed-port-range port-block-allocation	Динамическое отображение клона исходного параметра с суффиксом.
endip string		Конечный IPv4-адрес (включительно) в диапазоне для пула адресов (формат xxx.xxx.xxx.xxx, По умолчанию\| 0.0.0.0).
mode string	Варианты: add ← set delete update	Задает один из трех режимов управления объектом. Позволяет использовать soft-добавления вместо перезаписи существующих значений
name string		Имя пула IP-адресов.
num_blocks_per_user string		Количество блоков адресов, которые могут использоваться пользователем (от 1 до 128, по умолчанию = 8).
pba_timeout string		Тайм-аут выделения блока портов (секунды).
permit_any_host string	Варианты: disable enable	Включить/отключить NAT с полным конусом. choice \| disable \| Отключить NAT с полным конусом. choice \| enable \| Включить NAT с полным конусом.
source_endip string		Конечный IPv4-адрес (включительно) в диапазоне исходных адресов для преобразования (формат xxx.xxx.xxx.xxx, По умолчанию\| 0.0.0.0).
source_startip string		Первый IPv4-адрес (включительно) в диапазоне исходных адресов для преобразования (формат xxx.xxx.xxx.xxx, По умолчанию\| 0.0.0.0).
startip string		Первый IPv4-адрес (включительно) в диапазоне для пула адресов (формат xxx.xxx.xxx.xxx, По умолчанию\| 0.0.0.0).
type string	Варианты: overload one-to-one fixed-port-range port-block-allocation	Тип пула IP-адресов (перегрузка, один-к-одному, фиксированный диапазон портов или выделение блока портов). choice \| overload \| IP-адреса в пуле IP-адресов могут быть совместно использоваться клиентами. choice \| one-to-one \| Сопоставление один к одному. choice \| fixed-port-range \| Фиксированный диапазон портов. choice \| port-block-allocation \| Выделение блока портов.

Примечания

Примечание

Полная документация по адресу https://ftnt-ansible-docs.readthedocs.io/en/latest/.

Примеры

- name: ADD FMGR_FIREWALL_IPPOOL Overload
  community.network.fmgr_fwobj_ippool:
    mode: "add"
    adom: "ansible"
    name: "Ansible_pool4_overload"
    comments: "Created by ansible"
    type: "overload"

    # OPTIONS FOR ALL MODES
    startip: "10.10.10.10"
    endip: "10.10.10.100"
    arp_reply: "enable"

- name: ADD FMGR_FIREWALL_IPPOOL one-to-one
  community.network.fmgr_fwobj_ippool:
    mode: "add"
    adom: "ansible"
    name: "Ansible_pool4_121"
    comments: "Created by ansible"
    type: "one-to-one"

    # OPTIONS FOR ALL MODES
    startip: "10.10.20.10"
    endip: "10.10.20.100"
    arp_reply: "enable"

- name: ADD FMGR_FIREWALL_IPPOOL FIXED PORT RANGE
  community.network.fmgr_fwobj_ippool:
    mode: "add"
    adom: "ansible"
    name: "Ansible_pool4_fixed_port"
    comments: "Created by ansible"
    type: "fixed-port-range"

    # OPTIONS FOR ALL MODES
    startip: "10.10.40.10"
    endip: "10.10.40.100"
    arp_reply: "enable"
    # FIXED PORT RANGE OPTIONS
    source_startip: "192.168.20.1"
    source_endip: "192.168.20.20"

- name: ADD FMGR_FIREWALL_IPPOOL PORT BLOCK ALLOCATION
  community.network.fmgr_fwobj_ippool:
    mode: "add"
    adom: "ansible"
    name: "Ansible_pool4_port_block_allocation"
    comments: "Created by ansible"
    type: "port-block-allocation"

    # OPTIONS FOR ALL MODES
    startip: "10.10.30.10"
    endip: "10.10.30.100"
    arp_reply: "enable"
    # PORT BLOCK ALLOCATION OPTIONS
    block_size: "128"
    num_blocks_per_user: "1"

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

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

Ключ	Возвращается	Описание
api_result string	всегда	полный ответ API, включает код состояния и сообщение

Авторы

Luke Weighall (@lweighall)
Andrew Welsh (@Ghilli3)
Jim Huber (@p4r4n0y1ng)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/network/fmgr_fwobj_ippool_module.html