fortinet.fortimanager.fmgr_firewall_profileprotocoloptions_ftp – Настройка параметров протокола FTP.

Примечание

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

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

Для использования в плейбуке укажите: fortinet.fortimanager.fmgr_firewall_profileprotocoloptions_ftp.

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

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

Обзор

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
adom строка / обязательно			параметр (adom) в запрошенном URL
bypass_validation логическое		Варианты: нет ← да	устанавливать в True только при расхождениях схемы модуля со структурой API FortiManager, модуль продолжит выполнение без проверки параметров
firewall_profileprotocoloptions_ftp словарь			устанавливаемые параметры верхнего уровня
	comfort-amount целое число		Объем данных, отправляемых в передаче для комфортного взаимодействия с клиентом (1–10240 байт, по умолчанию = 1).
	comfort-interval целое число		Период времени между началом или последней передачей и следующей передачей данных для комфортного взаимодействия с клиентом (1–900 сек, по умолчанию = 10).
	inspect-all строка	Варианты: выключить включить	Включить/выключить проверку всех портов для протокола.
	options список / элементы=строка	Варианты: clientcomfort no-content-summary oversize splice bypass-rest-command bypass-mode-command	нет описания
	oversize-limit целое число		Максимальный размер файла в памяти, который может быть просканирован (1–383 МБ, по умолчанию = 10).
	ports целое число		нет описания
	scan-bzip2 строка	Варианты: выключить включить	Включить/выключить сканирование файлов, сжатых в формате BZip2.
	status строка	Варианты: выключить включить	Включить/выключить активный статус сканирования для этого протокола.
	uncompressed-nest-limit целое число		Максимальное количество уровней вложенного сжатия, которое может быть распаковано и просканировано (2–100, по умолчанию = 12).
	uncompressed-oversize-limit целое число		Максимальный размер нескомпрессированного файла в памяти, который может быть просканирован (0–383 МБ, 0 = без ограничений, по умолчанию = 10).
profile-protocol-options строка / обязательно			параметр (profile-protocol-options) в запрошенном URL
rc_failed список / элементы=строка			список кодов rc, при которых будет выполнена отмена условий
rc_succeeded список / элементы=строка			список кодов rc, при которых будут выполнены условия успеха
state строка / обязательно		Варианты: present absent	директива для создания, обновления или удаления объекта
workspace_locking_adom строка			adom для блокировки в режиме работы FortiManager в рабочем пространстве, значение может быть глобальным и другими, включая корневой
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 FTP protocol options.
     fmgr_firewall_profileprotocoloptions_ftp:
        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_ftp:
           comfort-amount: <value of integer>
           comfort-interval: <value of integer>
           inspect-all: <value in [disable, enable]>
           options:
             - clientcomfort
             - no-content-summary
             - oversize
             - splice
             - bypass-rest-command
             - bypass-mode-command
           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_ftp_module.html