Модуль f5networks.f5_modules.bigip_remote_syslog – Управление настройками удалённого syslog на BIG-IP

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.31.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install f5networks.f5_modules.

Чтобы использовать её в книге задач, укажите: f5networks.f5_modules.bigip_remote_syslog.

Добавлен в f5networks.f5_modules 1.0.0

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

Обзор

Управление настройками удалённого syslog на системе BIG-IP.

Параметры

Параметр	Комментарии
local_ip строка	Указывает локальный IP-адрес системы, которая ведёт логирование. Для отключения локального IP-адреса укажите значение `none`. При создании удалённого syslog, если этот параметр не указан, используется значение по умолчанию `none`.
name строка	Указывает имя объекта syslog. Этот параметр необходим, когда на устройстве присутствуют несколько `remote_host` с одинаковым IP-адресом или именем хоста. Если `name` не указан, используется значение по умолчанию `remote_host`.
provider словарь добавлен в f5networks.f5_modules 1.0.0	Объект словаря, содержащий данные подключения.
auth_provider строка	Настраивает провайдера аутентификации для получения маркеров аутентификации с удалённого устройства. Этот параметр используется при работе с устройствами BIG-IQ.
no_f5_teem булево	Если `yes`, данные телеметрии TEEM не отправляются в F5. Этот параметр можно опустить, установив переменную окружения `F5_TELEMETRY_OFF`. Предыдущая переменная `F5_TEEM` устарела, так как её название вызывало путаницу. Варианты: `false` ← (по умолчанию) `true`
пароль псевдонимы: pass, pwd строка / обязательно	Пароль для учётной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Этот параметр можно опустить, установив переменную окружения `F5_PASSWORD`.
сервер строка / обязательно	Хост BIG-IP или BIG-IQ. Этот параметр можно опустить, установив переменную окружения `F5_SERVER`.
server_port целое число	Порт сервера BIG-IP. Этот параметр можно опустить, установив переменную окружения `F5_SERVER_PORT`. По умолчанию: `443`
timeout целое число	Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истечёт до завершения операции, модуль выдаст ошибку.
transport строка	Настраивает транспортное соединение для подключения к удалённому устройству. Варианты: `"rest"` ← (по умолчанию)
user строка / обязательно	Имя пользователя для подключения к BIG-IP или BIG-IQ. Этот пользователь должен иметь административные права на устройстве. Этот параметр можно опустить, установив переменную окружения `F5_USER`.
validate_certs булево	Если `no`, сертификаты SSL не проверяются. Используйте только на управляемых вами сайтах с самозаверяющимися сертификатами. Этот параметр можно опустить, установив переменную окружения `F5_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
remote_host строка / обязательно	Указывает IP-адрес или имя хоста удалённой системы, на которую система отправляет сообщения об ошибках.
remote_port строка	Указывает порт, используемый системой для отправки сообщений на удалённый сервер регистрации событий. При создании удалённого syslog, если этот параметр не указан, используется значение по умолчанию `514`.
state строка	При значении `present`, гарантирует, что удалённый syslog существует с указанными атрибутами. При значении `absent`, удаляет удалённый syslog с системы. Варианты: `"absent"` `"present"` ← (по умолчанию)

Примечания

Примечание

Для получения дополнительной информации об использовании Ansible для управления устройствами F5 Networks см. https://www.ansible.com/integrations/networks/f5.
Требуется версия программного обеспечения BIG-IP >= 12.
Модули F5 манипулируют только текущей конфигурацией продукта F5. Чтобы гарантировать сохранение конфигурации BIG-IP на диске, необходимо включить по крайней мере одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.

Примеры

- name: Add a remote syslog server to log to
  bigip_remote_syslog:
    remote_host: 10.10.10.10
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Add a remote syslog server on a non-standard port to log to
  bigip_remote_syslog:
    remote_host: 10.10.10.10
    remote_port: 1234
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

Значения возврата

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

Ключ	Описание
local_ip строка	Новый локальный IP-адрес сервера удаленного syslog. Возвращено: изменён Пример: `"10.10.10.10"`
remote_port целое число	Новый порт удаленного сервера удаленного syslog. Возвращено: изменён Пример: `514`

Авторы

Tim Rupp (@caphrim007)
Wojciech Wypior (@wojtek0806)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/f5networks/f5_modules/bigip_remote_syslog_module.html