fortinet.fortimanager.fmgr_firewall_profileprotocoloptions_imap — Настройка параметров протокола IMAP.

Примечание

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

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

Чтобы использовать его в книге задач, укажите: fortinet.fortimanager.fmgr_firewall_profileprotocoloptions_imap.

Новое в версии 2.10: модуля fortinet.fortimanager

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

Обзор

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
adom строка / обязательно			параметр (adom) в запрошенном URL
bypass_validation булево		Варианты: нет ← да	устанавливается только в случае расхождения схемы модуля со структурой API FortiManager, модуль продолжает выполнение без проверки параметров
firewall_profileprotocoloptions_imap словарь			устанавливаемые параметры верхнего уровня
	inspect-all строка	Варианты: отключить включить	Включение/выключение проверки всех портов для протокола.
	options список / элементы=строка	Варианты: oversize fragmail no-content-summary	без описания
	oversize-limit целое число		Максимальный размер файла в памяти, который может быть просканирован (от 1 до 383 МБ, по умолчанию 10).
	ports целое число		без описания
	scan-bzip2 строка	Варианты: отключить включить	Включение/выключение сканирования файлов, сжатых в формате BZip2.
	status строка	Варианты: отключить включить	Включение/выключение активного статуса сканирования для этого протокола.
	uncompressed-nest-limit целое число		Максимальное количество вложенных уровней сжатия, которые могут быть распакованы и просканированы (от 2 до 100, по умолчанию 12).
	uncompressed-oversize-limit целое число		Максимальный размер файла в памяти после распаковки, который может быть просканирован (0 — без ограничений, 0 — неограниченно, по умолчанию 10).
profile-protocol-options строка / обязательно			параметр (profile-protocol-options) в запрошенном URL
rc_failed список / элементы=строка			список кодов rc, при которых условия будут нарушены
rc_succeeded список / элементы=строка			список кодов rc, при которых условия будут выполнены
state строка / обязательно		Варианты: present absent	направление для создания, обновления или удаления объекта
workspace_locking_adom строка			область, которую нужно заблокировать для FortiManager, работающего в режиме рабочей области, значение может быть глобальным или другими, включая 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 IMAP protocol options.
     fmgr_firewall_profileprotocoloptions_imap:
        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>
        profile-protocol-options: <your own value>
        firewall_profileprotocoloptions_imap:
           inspect-all: <value in [disable, enable]>
           options:
             - oversize
             - fragmail
             - no-content-summary
           oversize-limit: <value of integer>
           ports: <value of integer>
           scan-bzip2: <value in [disable, enable]>
           status: <value in [disable, enable]>
           uncompressed-nest-limit: <value of integer>
           uncompressed-oversize-limit: <value of integer>

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

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

Ключ	Возвращаемое значение	Описание
request_url строка	всегда	Полный запрос URL Пример: /sys/login/user
response_code целое число	всегда	Статус запроса API
response_message строка	всегда	Описание ответа 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_profileprotocoloptions_imap_module.html