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

Новое в версии 2.8.

Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Описание

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

Параметры

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

Статус

Не гарантируется обратная совместимость интерфейса этого модуля. [preview]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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.8/modules/fmgr_fwobj_ippool_module.html