fortinet.fortimanager.fmgr_fmupdate_fdssetting_updateschedule – Настройка расписания для получения обновлений антивируса и IPS встроенным FortiGuard.

Примечание

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

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

Для использования в книге задач укажите: fortinet.fortimanager.fmgr_fmupdate_fdssetting_updateschedule.

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

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

Описание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
bypass_validation boolean		Варианты: нет ← да	устанавливается в True только тогда, когда схема модуля отличается от структуры API FortiManager, модуль продолжает выполнение без проверки параметров
fmupdate_fdssetting_updateschedule словарь			параметры верхнего уровня
	day строка	Варианты: Воскресенье Понедельник ← Вторник Среда Четверг Пятница Суббота	Указывает день проведения обновления, если частота еженедельная (Воскресенье - Суббота, по умолчанию - Понедельник). Воскресенье - Обновление каждое воскресенье. Понедельник - Обновление каждый понедельник. Вторник - Обновление каждый вторник. Среда - Обновление каждую среду. Четверг - Обновление каждый четверг. Пятница - Обновление каждую пятницу. Суббота - Обновление каждую субботу.
	frequency строка	Варианты: каждые ← ежедневно еженедельно	Настройка частоты обновления: каждый - интервал времени, ежедневно - один раз в день, еженедельно - один раз в неделю (по умолчанию - каждый). каждые - интервал времени. ежедневно - каждый день. еженедельно - каждую неделю.
	status строка	Варианты: отключить включить ←	Включение/отключение запланированных обновлений. отключить - Отключить настройку. включить - Включить настройку.
	time строка		нет описания
rc_failed список / элементы=строка			список кодов rc, при которых выполнение будет остановлено
rc_succeeded список / элементы=строка			список кодов rc, при которых выполнение будет завершено успешно
state строка / обязательно		Варианты: present absent	указание на создание, обновление или удаление объекта
workspace_locking_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 the schedule when built-in FortiGuard retrieves antivirus and IPS updates.
     fmgr_fmupdate_fdssetting_updateschedule:
        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_fdssetting_updateschedule:
           day: <value in [Sunday, Monday, Tuesday, ...]>
           frequency: <value in [every, daily, weekly]>
           status: <value in [disable, enable]>
           time: <value of string>

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

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

Ключ	Возвращаемое значение	Описание
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_fmupdate_fdssetting_updateschedule_module.html