Spec-Zone.ru › Ansible

fortinet.fortimanager.fmgr_system_locallog_fortianalyzer2_setting module – Настройки локального журнала для FortiAnalyzer.

Примечание

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

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

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

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

Добавлено в fortinet.fortimanager 2.0.0

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

Краткое описание

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

Параметры

Параметр

Комментарии

access_token

string

Токен для доступа к FortiManager без использования имени пользователя и пароля.

bypass_validation

boolean

Устанавливайте значение True только в том случае, если схема модуля отличается от структуры API FortiManager. Модуль продолжит работу без проверки параметров.

Возможные значения:

  • false ← (по умолчанию)
  • true

enable_log

boolean

Включить/отключить ведение журнала для задачи.

Возможные значения:

  • false ← (по умолчанию)
  • true

forticloud_access_token

string

Аутентификация клиента Ansible с помощью токена доступа к API forticloud.

proposed_method

string

Переопределённый метод для базового запроса Json RPC.

Возможные значения:

  • "update"
  • "set"
  • "add"

rc_failed

list / elements=integer

Список кодов rc, используемый для переопределения условий ошибки.

rc_succeeded

list / elements=integer

Список кодов rc, используемый для переопределения условий успешного выполнения.

system_locallog_fortianalyzer2_setting

dictionary

Параметры верхнего уровня.

peer_cert_cn

псевдонимы: peer-cert-cn

string

Общее имя сертификата удалённого FortiAnalyzer.

reliable

string

Включить/отключить надёжное ведение журналов в реальном времени.

disable — отключить надёжное ведение журналов в реальном времени.

enable — включить надёжное ведение журналов в реальном времени.

Возможные значения:

  • "disable"
  • "enable"

secure_connection

псевдонимы: secure-connection

string

Включить/отключить защищённое TLS/SSL-соединение.

disable — отключить SSL-соединение.

enable — включить SSL-соединение.

Возможные значения:

  • "disable"
  • "enable"

server

string

FQDN, имя узла или IP-адрес удалённого сервера FortiAnalyzer

server_ip

псевдонимы: server-ip

string

IP-адрес удалённого сервера FortiAnalyzer.

severity

string

Минимальный уровень важности записей в журнале.

emergency — уровень «Аварийная ситуация».

alert — уровень «Тревога».

critical — уровень «Критический».

error — уровень «Ошибка».

warning — уровень «Предупреждение».

notification — уровень «Уведомление».

information — уровень «Информация».

debug — уровень «Отладка».

Возможные значения:

  • "emergency"
  • "alert"
  • "critical"
  • "error"
  • "warning"
  • "notification"
  • "information"
  • "debug"

status

string

Состояние ведения журнала в FortiAnalyzer.

disable — ведение журнала в FortiAnalyzer отключено.

realtime — ведение журнала в FortiAnalyzer в режиме реального времени.

upload — отправка журнала в FortiAnalyzer по расписанию.

Возможные значения:

  • "disable"
  • "realtime"
  • "upload"

upload_time

псевдонимы: upload-time

any

(список) Время отправки файлов локального журнала

workspace_locking_adom

string

ADOM, который нужно заблокировать для FortiManager, работающего в режиме рабочей области. Значением может быть global или другое значение, включая 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: Settings for locallog to fortianalyzer.
      fortinet.fortimanager.fmgr_system_locallog_fortianalyzer2_setting:
        # workspace_locking_adom: <global or your adom name>
        system_locallog_fortianalyzer2_setting:
          # reliable: <value in [disable, enable]>
          # secure_connection: <value in [disable, enable]>
          # server_ip: <string>
          # severity: <value in [emergency, alert, critical, ...]>
          # status: <value in [disable, realtime, upload]>
          # upload_time: <list or string>
          # server: <string>
          # peer_cert_cn: <string>

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

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

Ключ

Описание

meta

dictionary

Результат запроса.

Возвращается: всегда

request_url

string

Полный URL запроса.

Возвращается: всегда

Пример: "/sys/login/user"

response_code

integer

Статус запроса API.

Возвращается: всегда

Пример: 0

response_data

list / elements=string

Ответ API.

Возвращается: всегда

response_message

string

Описание ответа API.

Возвращается: всегда

Пример: "OK."

system_information

dictionary

Информация о целевой системе.

Возвращается: всегда

rc

integer

Статус запроса.

Возвращается: всегда

Пример: 0

version_check_warning

list / elements=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_system_locallog_fortianalyzer2_setting_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API