Модуль fortinet.fortimanager.fmgr_pkg_firewall_policy46 — настройка политик IPv4 в IPv6.

Примечание

Этот модуль входит в коллекцию fortinet.fortimanager (версия 2.14.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install fortinet.fortimanager.

Чтобы использовать её в плейбуке, укажите: fortinet.fortimanager.fmgr_pkg_firewall_policy46.

Добавлено в fortinet.fortimanager 2.0.0

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

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

Параметры

Параметр	Комментарии
access_token string	Токен для доступа к FortiManager без использования имени пользователя и пароля.
adom string / обязательный	Параметр (adom) в запрошенном URL.
bypass_validation boolean	Устанавливайте значение True только в случае, если схема модуля отличается от структуры API FortiManager. Модуль продолжит выполнение без проверки параметров. Варианты: `false` ← (по умолчанию) `true`
enable_log boolean	Включить или отключить ведение журнала для задачи. Варианты: `false` ← (по умолчанию) `true`
forticloud_access_token string	Аутентификация клиента Ansible с помощью токена доступа к API forticloud.
pkg string / обязательный	Параметр (pkg) в запрошенном URL.
pkg_firewall_policy46 dictionary	Параметры верхнего уровня.
action string	Разрешить или запретить трафик, соответствующий политике. Варианты: `"deny"` `"accept"`
cgn_log_server_grp псевдонимы: cgn-log-server-grp string	Имя группы серверов журналов NP
comments string	Комментарий.
dstaddr any	(список или строка) Объекты адресов назначения.
dstintf string	Имя интерфейса назначения.
fixedport string	Включить или отключить фиксированный порт для этой политики. Варианты: `"disable"` `"enable"`
ippool string	Включить или отключить использование пулов IP-адресов для NAT источника. Варианты: `"disable"` `"enable"`
logtraffic string	Включить или отключить ведение журнала трафика для этой политики. Варианты: `"disable"` `"enable"`
logtraffic_start псевдонимы: logtraffic-start string	Записывать события в журнал при начале и завершении сеанса. Варианты: `"disable"` `"enable"`
name string	Имя политики.
per_ip_shaper псевдонимы: per-ip-shaper string	Ограничитель трафика для каждого IP-адреса.
permit_any_host псевдонимы: permit-any-host string	Включить или отключить разрешение для любого узла. Варианты: `"disable"` `"enable"`
policy_offload псевдонимы: policy-offload string	Включить или отключить аппаратную настройку сеансов для CGNAT. Варианты: `"disable"` `"enable"`
policyid integer / обязательный	Идентификатор политики.
poolname any	(список или строка) Имена пулов IP-адресов.
schedule string	Имя расписания.
service any	(список или строка) Имя службы.
srcaddr any	(список или строка) Объекты адресов источника.
srcintf string	Имя интерфейса источника.
status string	Включить или отключить эту политику. Варианты: `"disable"` `"enable"`
tags string	Применённые теги объекта.
tcp_mss_receiver псевдонимы: tcp-mss-receiver integer	Значение максимального размера сегмента TCP для получателя
tcp_mss_sender псевдонимы: tcp-mss-sender integer	Значение максимального размера сегмента TCP для отправителя
traffic_shaper псевдонимы: traffic-shaper string	Ограничитель трафика.
traffic_shaper_reverse псевдонимы: traffic-shaper-reverse string	Ограничитель обратного трафика.
uuid string	Универсальный уникальный идентификатор
proposed_method string	Переопределённый метод для базового запроса Json RPC. Варианты: `"update"` `"set"` `"add"`
rc_failed list / элементы=integer	Список кодов rc, переопределяющий условия завершения с ошибкой.
rc_succeeded list / элементы=integer	Список кодов rc, переопределяющий условия успешного завершения.
revision_note string	Примечание об изменении, которое можно указать при создании или обновлении объекта.
state string / обязательный	Указание на создание, обновление или удаление объекта. Варианты: `"present"` `"absent"`
workspace_locking_adom string	ADOM для блокировки в FortiManager, работающем в режиме рабочей области. Значением может быть global или другие ADOM, включая root.
workspace_locking_timeout integer	Максимальное время ожидания в секундах, пока другой пользователь снимет блокировку рабочей области. По умолчанию: `300`

Примечания

Примечание

Начиная с версии 2.4.0, имена всех входных аргументов соответствуют соглашению с подчёркиваниями (snake_case). Замените аргументы вида «var-name» на «var_name». Старые имена аргументов по-прежнему доступны, однако будут выдаваться предупреждения об устаревании. Чтобы игнорировать это предупреждение, установите deprecation_warnings=False в ansible.cfg.
Этот модуль FortiManager поддерживает работу в режиме блокировки рабочей области; для этого предназначены параметры верхнего уровня workspace_locking_adom и workspace_locking_timeout.
Обычно выполнение модуля может завершиться ошибкой при возврате ненулевого значения rc. Условия завершения с ошибкой или успехом можно переопределить параметрами rc_failed и rc_succeeded.
Для создания или обновления объекта используйте директиву state present.
Для удаления объекта используйте директиву state absent.

Примеры

- name: Example playbook
  hosts: fortimanagers
  gather_facts: false
  connection: httpapi
  vars:
    ansible_httpapi_use_ssl: true
    ansible_httpapi_validate_certs: false
    ansible_httpapi_port: 443
  tasks:
    - name: Configure IPv4 to IPv6 policies.
      fortinet.fortimanager.fmgr_pkg_firewall_policy46:
        bypass_validation: true
        adom: ansible
        pkg: ansible # package name
        state: present
        pkg_firewall_policy46:
          action: accept # <value in [deny, accept]>
          comments: ansible-comment
          dstaddr: ansible-test-vip46
          dstintf: any
          policyid: 1
          schedule: always
          service: ALL
          srcaddr: all
          srcintf: any
          status: disable

- name: Gathering fortimanager facts
  hosts: fortimanagers
  gather_facts: false
  connection: httpapi
  vars:
    ansible_httpapi_use_ssl: true
    ansible_httpapi_validate_certs: false
    ansible_httpapi_port: 443
  tasks:
    - name: Retrieve all the IPv4 to IPv6 policies
      fortinet.fortimanager.fmgr_fact:
        facts:
          selector: "pkg_firewall_policy46"
          params:
            adom: "ansible"
            pkg: "ansible" # package name
            policy46: "your_value"

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

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

Ключ	Описание
meta dictionary	Результат запроса. Возвращается: всегда
request_url string	Полный URL запроса. Возвращается: всегда Пример: `"/sys/login/user"`
response_code integer	Статус запроса API. Возвращается: всегда Пример: `0`
response_data list / элементы=string	Ответ API. Возвращается: всегда
response_message string	Описание ответа API. Возвращается: всегда Пример: `"OK."`
system_information dictionary	Информация о целевой системе. Возвращается: всегда
rc integer	Статус запроса. Возвращается: всегда Пример: `0`
version_check_warning list / элементы=string	Предупреждение, если используемые в плейбуке параметры не поддерживаются текущей версией FortiManager. Возвращается: для сложных случаев

Авторы

Xinwei Du (@dux-fortinet)
Xing Li (@lix-fortinet)
Jie Xue (@JieX19)
Link Zheng (@chillancezen)
Frank Shen (@fshen01)
Hongbin Lu (@fgtdev-hblu)

Ссылки на коллекцию

© 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/fortinet/fortimanager/fmgr_pkg_firewall_policy46_module.html