Модуль fortinet.fortimanager.fmgr_firewall_mmsprofile_flood — конфигурация защиты от флуда.

Примечание

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

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

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

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

Добавлено в 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`
firewall_mmsprofile_flood dictionary	Набор параметров верхнего уровня.
action1 list / элементы=string	Действие при достижении порогового значения. Варианты: `"log"` `"archive"` `"intercept"` `"block"` `"archive-first"` `"alert-notif"`
action2 list / элементы=string	Действие при достижении порогового значения. Варианты: `"log"` `"archive"` `"intercept"` `"block"` `"archive-first"` `"alert-notif"`
action3 list / элементы=string	Действие при достижении порогового значения. Варианты: `"log"` `"archive"` `"intercept"` `"block"` `"archive-first"` `"alert-notif"`
block_time1 псевдонимы: block-time1 integer	Продолжительность действия меры
block_time2 псевдонимы: block-time2 integer	Продолжительность действия меры
block_time3 псевдонимы: block-time3 integer	Продолжительность действия меры
limit1 integer	Максимально допустимое количество сообщений.
limit2 integer	Максимально допустимое количество сообщений.
limit3 integer	Максимально допустимое количество сообщений.
protocol string	Протокол.
status1 string	Включить или отключить обнаружение status1. Варианты: `"disable"` `"enable"`
status2 string	Включить или отключить обнаружение status2. Варианты: `"disable"` `"enable"`
status3 string	Включить или отключить обнаружение status3. Варианты: `"disable"` `"enable"`
window1 integer	Интервал, за который подсчитываются сообщения
window2 integer	Интервал, за который подсчитываются сообщения
window3 integer	Интервал, за который подсчитываются сообщения
forticloud_access_token string	Аутентификация клиента Ansible с помощью токена доступа к API forticloud.
mms-profile string	Устарел, используйте «mms_profile»
mms_profile string	Параметр (mms-profile) в запрашиваемом URL.
proposed_method string	Переопределённый метод для базового запроса Json RPC. Варианты: `"update"` `"set"` `"add"`
rc_failed list / элементы=integer	Список кодов rc, переопределяющий условия, при которых выполнение считается неудачным.
rc_succeeded list / элементы=integer	Список кодов rc, переопределяющий условия, при которых выполнение считается успешным.
revision_note string	Примечание об изменении, которое можно указать при создании или обновлении объекта.
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.

Примеры

- name: Example playbook (generated based on argument schema)
  hosts: fortimanagers
  connection: httpapi
  gather_facts: false
  tasks:
    - name: Flood configuration.
      fortinet.fortimanager.fmgr_firewall_mmsprofile_flood:
        # workspace_locking_adom: <global or your adom name>
        adom: <your own value>
        mms_profile: <your own value>
        firewall_mmsprofile_flood:
          # action1: ["log", "archive", "intercept", "block", "archive-first", "alert-notif"]
          # action2: ["log", "archive", "intercept", "block", "archive-first", "alert-notif"]
          # action3: ["log", "archive", "intercept", "block", "archive-first", "alert-notif"]
          # block_time1: <integer>
          # block_time2: <integer>
          # block_time3: <integer>
          # limit1: <integer>
          # limit2: <integer>
          # limit3: <integer>
          # protocol: <string>
          # status1: <value in [disable, enable]>
          # status2: <value in [disable, enable]>
          # status3: <value in [disable, enable]>
          # window1: <integer>
          # window2: <integer>
          # window3: <integer>

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

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

Ключ	Описание
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_firewall_mmsprofile_flood_module.html