модуль fortinet.fortimanager.fmgr_system_locallog_syslogd_setting — настройки удаленного сервера syslog.
Примечание
Этот модуль входит в коллекцию fortinet.fortimanager (версия 2.14.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install fortinet.fortimanager.
Чтобы использовать модуль в плейбуке, укажите: fortinet.fortimanager.fmgr_system_locallog_syslogd_setting.
Добавлено в fortinet.fortimanager 2.0.0
Краткое описание
- Этот модуль позволяет настроить устройство FortiManager.
- Примеры включают все параметры и значения, которые перед использованием необходимо скорректировать в соответствии с источниками данных.
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Токен для доступа к FortiManager без использования имени пользователя и пароля. |
bypass_validation boolean | Устанавливайте значение True только в том случае, если схема модуля отличается от структуры API FortiManager. Модуль продолжит выполнение без проверки параметров. Варианты:
|
enable_log boolean | Включить или отключить ведение журнала для задачи. Варианты:
|
forticloud_access_token string | Аутентификация клиента Ansible с помощью токена доступа к API FortiCloud. |
proposed_method string | Переопределенный метод для базового запроса Json RPC. Варианты:
|
rc_failed list / элементы=integer | Список кодов rc, с помощью которого переопределяются условия сбоя. |
rc_succeeded list / элементы=integer | Список кодов rc, с помощью которого переопределяются условия успешного выполнения. |
system_locallog_syslogd_setting dictionary | Набор параметров верхнего уровня. |
|
cert string |
Выберите локальный сертификат для защищенного соединения. |
|
csv string |
Формат CSV. disable — отключить формат CSV. enable — включить формат CSV. Варианты:
|
|
facility string |
Средство удаленного syslog. kernel — сообщения ядра. user — случайные сообщения пользовательского уровня. ntp — служба NTP. audit — аудит журнала. alert — предупреждение в журнале. clock — служба часов. mail — почтовая система. daemon — системные службы. auth — сообщения безопасности и авторизации. syslog — сообщения, созданные службой syslog. lpr — подсистема линейной печати. news — подсистема сетевых новостей. uucp — подсистема сетевых новостей. cron — служба часов. authpriv — сообщения безопасности и авторизации ftp — служба FTP. local0 — зарезервировано для локального использования. local1 — зарезервировано для локального использования. local2 — зарезервировано для локального использования. local3 — зарезервировано для локального использования. local4 — зарезервировано для локального использования. local5 — зарезервировано для локального использования. local6 — зарезервировано для локального использования. local7 — зарезервировано для локального использования. Варианты:
|
|
reliable string |
Включить или отключить надежное ведение журнала в реальном времени. disable — отключить надежное ведение журнала в реальном времени. enable — включить надежное ведение журнала в реальном времени. Варианты:
|
|
secure_connection псевдонимы: secure-connection string |
Включить или отключить защиту соединения с помощью TLS/SSL. disable — отключить SSL-соединение. enable — включить SSL-соединение. Варианты:
|
|
severity string |
Минимальный уровень важности сообщений для записи в журнал. emergency — аварийный уровень. alert — уровень предупреждения. critical — критический уровень. error — уровень ошибки. warning — уровень предупреждения. notification — уровень уведомления. information — информационный уровень. debug — уровень отладки. Варианты:
|
|
status string |
Ведение журнала на удаленный сервер syslog. disable — не вести журнал на удаленном сервере syslog. enable — вести журнал на удаленном сервере syslog. Варианты:
|
|
syslog_name псевдонимы: syslog-name string |
Имя удаленного сервера syslog. |
workspace_locking_adom string | ADOM, который нужно заблокировать для FortiManager, работающего в режиме рабочей области. В качестве значения можно указать global или другие ADOM, включая root. |
workspace_locking_timeout integer | Максимальное время в секундах ожидания, пока другой пользователь снимет блокировку рабочей области. По умолчанию: |
Примечания
Примечание
- Начиная с версии 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 remote syslog server.
fortinet.fortimanager.fmgr_system_locallog_syslogd_setting:
# workspace_locking_adom: <global or your adom name>
system_locallog_syslogd_setting:
# csv: <value in [disable, enable]>
# facility: <value in [kernel, user, ntp, ...]>
# severity: <value in [emergency, alert, critical, ...]>
# status: <value in [disable, enable]>
# syslog_name: <string>
# cert: <string>
# reliable: <value in [disable, enable]>
# secure_connection: <value in [disable, enable]>
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
meta dictionary | Результат запроса. Возвращается: всегда |
|
request_url string |
Полный URL запроса. Возвращается: всегда Пример: |
|
response_code integer |
Статус запроса API. Возвращается: всегда Пример: |
|
response_data list / элементы=string |
Ответ API. Возвращается: всегда |
|
response_message string |
Текстовое описание ответа API. Возвращается: всегда Пример: |
|
system_information dictionary |
Информация о целевой системе. Возвращается: всегда |
rc integer | Статус запроса. Возвращается: всегда Пример: |
version_check_warning list / элементы=string | Предупреждение, если используемые в плейбуке параметры не поддерживаются текущей версией FortiManager. Возвращается: в сложных случаях |
Ссылки на коллекцию
© 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_syslogd_setting_module.html