fortinet.fortimanager.fmgr_firewall_ippool – Настройка пулов IPv4-адресов.

Примечание

Этот плагин является частью коллекции fortinet.fortimanager (версия 2.0.1).

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

Для использования в playbook, укажите: fortinet.fortimanager.fmgr_firewall_ippool.

Новое в версии 2.10: fortinet.fortimanager

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

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

Этот модуль позволяет настраивать устройство FortiManager.
Примеры включают все параметры и значения, которые необходимо скорректировать в источниках данных перед использованием.

Параметры

Параметр				Варианты/Значения по умолчанию	Комментарии
adom строка / обязательно					параметр (adom) в запрошенном URL
bypass_validation логическое значение				Варианты: нет ← да	устанавливать в True только когда схема модуля отличается от структуры API FortiManager, модуль продолжает выполнение без валидации параметров
firewall_ippool словарь					параметры верхнего уровня
	arp-intf строка				Выберите интерфейс из доступных вариантов, который будет отвечать на ARP-запросы. (Если пусто, выбирается любой).
	arp-reply строка			Варианты: disable enable	Включить/выключить ответы на ARP-запросы при добавлении пула IP-адресов к политике (по умолчанию = enable).
	associated-interface строка				Имя связанного интерфейса.
	block-size целое число				Количество адресов в блоке (от 64 до 4096, по умолчанию = 128).
	comments строка				Комментарий.
	dynamic_mapping список / элементы=строка				no description
		_scope список / элементы=строка			no description
			name строка		no description
			vdom строка		no description
		arp-intf строка			no description
		arp-reply строка		Варианты: disable enable	no description
		associated-interface строка			no description
		block-size целое число			no description
		comments строка			no description
		endip строка			no description
		num-blocks-per-user целое число			no description
		pba-timeout целое число			no description
		permit-any-host строка		Варианты: disable enable	no description
		source-endip строка			no description
		source-startip строка			no description
		startip строка			no description
		type строка		Варианты: overload one-to-one fixed-port-range port-block-allocation	no description
	endip строка				Конечный IPv4-адрес (включительно) в диапазоне для пула адресов (формат xxx.xxx.xxx.xxx, по умолчанию: 0.0.0.0).
	name строка				Имя пула IP-адресов.
	num-blocks-per-user целое число				Количество блоков адресов, которые могут быть использованы пользователем (от 1 до 128, по умолчанию = 8).
	pba-timeout целое число				Время ожидания выделения блока портов (секунды).
	permit-any-host строка			Варианты: disable enable	Включить/выключить full cone 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, fixed port range или port block allocation).
rc_failed список / элементы=строка					список кодов rc, с помощью которых будут переопределены условия для сбоя
rc_succeeded список / элементы=строка					список кодов rc, с помощью которых будут переопределены условия для успеха
state строка / обязательно				Варианты: present absent	директива для создания, обновления или удаления объекта
workspace_locking_adom строка					adom для блокировки для FortiManager, работающего в режиме рабочей области, значение может быть global и другими, включая root
workspace_locking_timeout целое число				Значение по умолчанию: 300	максимальное время в секундах ожидания освобождения блокировки рабочей области другим пользователем

Примечания

Примечание

В этом модуле FortiManager поддерживается работа в режиме блокировки рабочей области, параметры верхнего уровня workspace_locking_adom и workspace_locking_timeout помогают в этом.
Для создания или обновления объекта используйте директиву state present.
Для удаления объекта используйте директиву state absent.
Обычно выполнение одного модуля может завершиться неудачей, когда возвращается ненулевой код rc. Вы также можете переопределить условия для сбоя или успеха с помощью параметров rc_failed и rc_succeeded

Примеры

- hosts: fortimanager-inventory
  collections:
    - fortinet.fortimanager
  connection: httpapi
  vars:
     ansible_httpapi_use_ssl: True
     ansible_httpapi_validate_certs: False
     ansible_httpapi_port: 443
  tasks:
   - name: Configure IPv4 IP pools.
     fmgr_firewall_ippool:
        bypass_validation: False
        workspace_locking_adom: <value in [global, custom adom including root]>
        workspace_locking_timeout: 300
        rc_succeeded: [0, -2, -3, ...]
        rc_failed: [-2, -3, ...]
        adom: <your own value>
        state: <value in [present, absent]>
        firewall_ippool:
           arp-intf: <value of string>
           arp-reply: <value in [disable, enable]>
           associated-interface: <value of string>
           block-size: <value of integer>
           comments: <value of string>
           dynamic_mapping:
             -
                 _scope:
                   -
                       name: <value of string>
                       vdom: <value of string>
                 arp-intf: <value of string>
                 arp-reply: <value in [disable, enable]>
                 associated-interface: <value of string>
                 block-size: <value of integer>
                 comments: <value of string>
                 endip: <value of string>
                 num-blocks-per-user: <value of integer>
                 pba-timeout: <value of integer>
                 permit-any-host: <value in [disable, enable]>
                 source-endip: <value of string>
                 source-startip: <value of string>
                 startip: <value of string>
                 type: <value in [overload, one-to-one, fixed-port-range, ...]>
           endip: <value of string>
           name: <value of string>
           num-blocks-per-user: <value of integer>
           pba-timeout: <value of integer>
           permit-any-host: <value in [disable, enable]>
           source-endip: <value of string>
           source-startip: <value of string>
           startip: <value of string>
           type: <value in [overload, one-to-one, fixed-port-range, ...]>

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

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

Ключ	Возвращаемое значение	Описание
request_url string	всегда	Полный запрашиваемый URL Пример: /sys/login/user
response_code integer	всегда	Статус запроса к API
response_message string	всегда	Дескриптивное сообщение ответа API Пример: OK.

Авторы

Link Zheng (@chillancezen)
Jie Xue (@JieX19)
Frank Shen (@fshen01)
Hongbin Lu (@fgtdev-hblu)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/fortinet/fortimanager/fmgr_firewall_ippool_module.html