Spec-Zone.ru › Ansible

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

Примечание

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

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

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

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

Добавлено в 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_policy64

dictionary

Параметры верхнего уровня.

action

string

Действие политики.

Варианты:

  • "deny"
  • "accept"

cgn_eif

псевдонимы: cgn-eif

string

Включить или отключить независимую от конечной точки фильтрацию CGN.

Варианты:

  • "disable"
  • "enable"

cgn_eim

псевдонимы: cgn-eim

string

Включить или отключить независимое от конечной точки сопоставление CGN.

Варианты:

  • "disable"
  • "enable"

cgn_log_server_grp

псевдонимы: cgn-log-server-grp

string

Имя группы серверов журналирования NP

cgn_resource_quota

псевдонимы: cgn-resource-quota

integer

Квота ресурсов

cgn_session_quota

псевдонимы: cgn-session-quota

integer

Квота сеансов

comments

string

Комментарий.

dstaddr

any

(список или строка) Имя адреса назначения.

dstintf

string

Имя интерфейса назначения.

fixedport

string

Включить или отключить фиксированный порт политики.

Варианты:

  • "disable"
  • "enable"

ippool

string

Включить или отключить пул IP-адресов policy64.

Варианты:

  • "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 MSS для получателя.

tcp_mss_sender

псевдонимы: tcp-mss-sender

integer

Значение TCP MSS для отправителя.

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 IPv6 to IPv4 policies.
      fortinet.fortimanager.fmgr_pkg_firewall_policy64:
        bypass_validation: false
        adom: ansible
        pkg: ansible # package name
        state: present
        pkg_firewall_policy64:
          action: accept # <value in [deny, accept]>
          comments: ansible-comment
          dstaddr: all
          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 IPv6 to IPv4 policies
      fortinet.fortimanager.fmgr_fact:
        facts:
          selector: "pkg_firewall_policy64"
          params:
            adom: "ansible"
            pkg: "ansible" # package name
            policy64: "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_policy64_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API