fortinet.fortimanager.fmgr_fmupdate_service – Включение/выключение служб, предоставляемых встроенным FortiGuard.

Примечание

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

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

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

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

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

Обзор

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
bypass_validation boolean		Варианты: нет ← да	устанавливается в True только в случае расхождения схемы модуля со структурой API FortiManager; модуль продолжает выполнение без проверки параметров
fmupdate_service dictionary			параметры верхнего уровня
	avips string	Варианты: disable enable ←	Включение/выключение встроенного FortiGuard для предоставления обновлений антивируса и IPS FortiGuard (по умолчанию = enable). disable - Отключить настройку. enable - Включить настройку.
	query-antispam string	Варианты: disable ← enable	Включение/выключение службы антиспама (по умолчанию = disable). disable - Отключить настройку. enable - Включить настройку.
	query-antivirus string	Варианты: disable ← enable	Включение/выключение службы запросов антивируса (по умолчанию = disable). disable - Отключить настройку. enable - Включить настройку.
	query-filequery string	Варианты: disable ← enable	Включение/выключение службы запросов файлов (по умолчанию = disable). disable - Отключить настройку. enable - Включить настройку.
	query-geoip string	Варианты: disable enable ←	Включение/выключение службы geoip (по умолчанию = enable). disable - Отключить настройку. enable - Включить настройку.
	query-outbreak-prevention string	Варианты: disable ← enable	Включение/выключение службы запросов по предотвращению вспышек (по умолчанию = disable). disable - Отключить настройку. enable - Включить настройку.
	query-webfilter string	Варианты: disable ← enable	Включение/выключение службы веб-фильтра (по умолчанию = disable). disable - Отключить настройку. enable - Включить настройку.
	webfilter-https-traversal string	Варианты: disable ← enable	Включение/выключение прохождения HTTPS через веб-фильтр (по умолчанию = disable). disable - Отключить настройку. enable - Включить настройку.
rc_failed list / elements=string			список rc-кодов, с которыми будут перезаданы условия для отказа
rc_succeeded list / elements=string			список rc-кодов, с которыми будут перезаданы условия для успеха
state string / required		Варианты: present absent	директива для создания, обновления или удаления объекта
workspace_locking_adom string			область, которую необходимо заблокировать для FortiManager, работающего в режиме рабочего пространства; значение может быть глобальным и другими, включая корневую
workspace_locking_timeout integer		По умолчанию: 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: Enable/disable services provided by the built-in FortiGuard.
     fmgr_fmupdate_service:
        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, ...]
        fmupdate_service:
           avips: <value in [disable, enable]>
           query-antispam: <value in [disable, enable]>
           query-antivirus: <value in [disable, enable]>
           query-filequery: <value in [disable, enable]>
           query-geoip: <value in [disable, enable]>
           query-outbreak-prevention: <value in [disable, enable]>
           query-webfilter: <value in [disable, enable]>
           webfilter-https-traversal: <value in [disable, enable]>

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

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

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