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

Примечание

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

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

Для использования в playbook, укажите: 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 строка	Значение по умолчанию: ""	Имя домена прокси-интерфейса. Требуется, если 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-адреса вместо имени домена. 0 (не использовать IP), 1 (использовать IP).
login_password строка / обязательно			Пароль пользователя Zabbix.
login_user строка / обязательно			Имя пользователя Zabbix.
proxy_address строка			Список IP/CIDR-адресов или имён доменов (через запятую), которые принимают активные запросы прокси. Требуется 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/zabbix/zabbix_proxy_module.html