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

Новая версия с 2.5.

Описание
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
- Автор

Описание

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

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

f5-sdk >= 3.0.9
netaddr

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
local_ip			Указывает локальный IP-адрес системы, которая производит логирование. Для того, чтобы не указывать локальный IP, задайте значение `none`. При создании удалённого syslog, если этот параметр не указан, используется значение по умолчанию `none`.
password обязательно			Пароль для учётной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_PASSWORD` установлена. псевдонимы: pass, pwd
provider (добавлен в 2.5)		По умолчанию: None	Объект dict, содержащий сведения о подключении.
	ssh_keyfile		Указывает SSH-ключ, который используется для аутентификации подключения к удалённому устройству. Этот аргумент используется только для транспортов cli. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	timeout	По умолчанию: 10	Указывает тайм-аут в секундах для связи с сетевым устройством при подключении или отправке команд. Если тайм-аут истечёт до завершения операции, модуль вернёт ошибку.
	server обязательно		Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER` установлена.
	user обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь права администратора на устройстве. Вы можете опустить этот параметр, если переменная среды `F5_USER` установлена.
	server_port	По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER_PORT` установлена.
	password обязательно		Пароль для учётной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_PASSWORD` установлена. псевдонимы: pass, pwd
	validate_certs	Варианты: no да ←	Если `no`, сертификаты SSL не будут проверены. Используйте это только на сайтах, контролируемых вами, с самозаверяющими сертификатами. Вы можете опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` установлена.
	transport обязательно	Варианты: rest cli ←	Настраивает транспортное подключение для подключения к удалённому устройству.
remote_host обязательно			Указывает IP-адрес или имя хоста для удалённой системы, в которую отправляются сообщения журнала.
remote_port			Указывает порт, используемый системой для отправки сообщений на удалённый сервер логирования. При создании удалённого syslog, если этот параметр не указан, используется значение по умолчанию `514`.
server обязательно			Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER` установлена.
server_port (добавлен в 2.2)		По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды `F5_SERVER_PORT` установлена.
state		Варианты: отсутствует наличие ←	Если `present`, гарантирует, что удалённый syslog существует с заданными атрибутами. Если `absent`, удаляет удалённый syslog из системы.
user обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь права администратора на устройстве. Вы можете опустить этот параметр, если переменная среды `F5_USER` установлена.
validate_certs (добавлен в 2.0)		Варианты: no да ←	Если `no`, сертификаты SSL не будут проверены. Используйте это только на сайтах, контролируемых вами, с самозаверяющими сертификатами. Вы можете опустить этот параметр, если переменная среды `F5_VALIDATE_CERTS` установлена.

Примечания

Примечание

Требуется пакет netaddr Python на хосте. Это легко сделать с помощью pip install netaddr.
Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на https://www.ansible.com/integrations/networks/f5.
Требуется пакет f5-sdk Python на хосте. Это так же просто, как pip install f5-sdk.

Примеры

- name: Add a remote syslog server to log to
  bigip_remote_syslog:
    remote_host: 10.10.10.10
    password: secret
    server: lb.mydomain.com
    user: admin
    validate_certs: no
  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
    password: secret
    server: lb.mydomain.com
    user: admin
    validate_certs: no
  delegate_to: localhost

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

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

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

Статус

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

Автор

Tim Rupp (@caphrim007)

Подсказка

Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/bigip_remote_syslog_module.html