community.zabbix.zabbix_proxy – Создание/удаление/получение/обновление прокси-серверов Zabbix

Примечание

Этот плагин входит в состав коллекции community.zabbix (версия 1.2.0).

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

Для использования в книге задач, укажите: community.zabbix.zabbix_proxy.

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

Обзор

Этот модуль позволяет создавать, изменять, получать и удалять записи прокси-серверов Zabbix.

Требования

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

python >= 2.6
zabbix-api >= 0.5.4

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
ca_cert строка			Издатель сертификата. псевдонимы: tls_issuer
description строка			Описание прокси-сервера.
http_login_password строка			Пароль Basic Auth
http_login_user строка			Логин Basic Auth
interface словарь		По умолчанию: {}	Словарь с параметрами для интерфейса, когда прокси-сервер находится в пассивном режиме. Для получения дополнительной информации, ознакомьтесь с документацией по интерфейсу прокси на https://www.zabbix.com/documentation/4.0/manual/api/reference/proxy/object#proxy_interface.
	dns строка	По умолчанию: ""	Имя DNS интерфейса прокси. Требуется, если useip=0.
	ip строка	По умолчанию: ""	IP-адрес, используемый интерфейсом прокси. Требуется, если useip=1.
	main целое число	По умолчанию: 0	Указывает, используется ли интерфейс в качестве основного. Этот подпараметр в настоящее время игнорируется для прокси Zabbix. Этот подпараметр устарел начиная с Ansible 2.10 и в конечном итоге будет удален в 2.14.
	port строка	По умолчанию: "10051"	Порт, используемый интерфейсом прокси.
	type целое число	По умолчанию: 0	Тип интерфейса для добавления. Этот подпараметр в настоящее время игнорируется для прокси Zabbix. Этот подпараметр устарел начиная с Ansible 2.10 и в конечном итоге будет удален в 2.14.
	useip целое число	Варианты: 0 1 По умолчанию: 0	Подключиться к интерфейсу прокси с IP-адресом вместо имени DNS. 0 (не использовать IP), 1 (использовать IP).
login_password строка / требуется			Пароль пользователя Zabbix.
login_user строка / требуется			Имя пользователя Zabbix.
proxy_address строка			Список IP/CIDR-адресов или имён DNS, разделенных запятыми, для приема запросов активных прокси. Требуется status=active. Работает только с >= Zabbix 4.0. ( опция удалена для <= 4.0 )
proxy_name строка / требуется			Имя прокси-сервера в Zabbix.
server_url строка / требуется			URL сервера Zabbix с протоколом (http или https). `url` — псевдоним для `server_url`. псевдонимы: url
state строка		Варианты: present ← absent	Состояние прокси-сервера. В `present`, он будет создан, если прокси не существует, или обновлён, если связанные данные отличаются. В `absent`, будет удален прокси, если он существует.
status строка		Варианты: active ← passive	Тип прокси-сервера. (4 — активный, 5 — пассивный)
timeout целое число		По умолчанию: 10	Таймаут запроса API (секунды).
tls_accept строка		Варианты: no_encryption ← PSK certificate	Подключения от прокси.
tls_connect строка		Варианты: no_encryption ← PSK certificate	Подключения к прокси.
tls_psk строка			Предопределенный ключ, по крайней мере 32 шестнадцатеричных цифры. Требуется, если либо tls_connect, либо tls_accept имеет включенный PSK.
tls_psk_identity строка			Идентификатор PSK. Требуется, если либо tls_connect, либо tls_accept имеет включенный PSK.
tls_subject строка			Предмет сертификата.
validate_certs булево		Варианты: no yes ←	Если установлено в False, SSL-сертификаты не будут проверены. Это следует использовать только на сайтах, контролируемых лично, используя самозаверяющие сертификаты.

Примечания

Примечание

Если вы используете login_password=zabbix, слово “zabbix” заменяется на “****” во всех выходных данных модуля, так как login_password использует no_log. См. эту страницу FAQ для получения дополнительной информации.

Примеры

- name: Create or update a proxy with proxy type active
  local_action:
    module: community.zabbix.zabbix_proxy
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    proxy_name: ExampleProxy
    description: ExampleProxy
    status: active
    state: present
    proxy_address: ExampleProxy.local

- name: Create a new passive proxy using only it's IP
  local_action:
    module: community.zabbix.zabbix_proxy
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    proxy_name: ExampleProxy
    description: ExampleProxy
    status: passive
    state: present
    interface:
      useip: 1
      ip: 10.1.1.2
      port: 10051

- name: Create a new passive proxy using only it's DNS
  local_action:
    module: community.zabbix.zabbix_proxy
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    proxy_name: ExampleProxy
    description: ExampleProxy
    status: passive
    state: present
    interface:
      dns: proxy.example.com
      port: 10051

Авторы

Alen Komic (@akomic)

© 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/community/zabbix/zabbix_proxy_module.html