zabbix_host - Создание/обновление/удаление хостов Zabbix
Новая версия 2.0.
Описание
- Этот модуль позволяет создавать, изменять и удалять записи хостов Zabbix, а также связанные данные групп и шаблонов.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- zabbix-api >= 0.5.3
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| описание (добавлено в 2.5) | Описание хоста в Zabbix. | |
| force bool (добавлено в 2.0) |
| Перезаписать конфигурацию хоста, даже если она уже существует. |
| host_groups | Список групп хостов, к которым принадлежит хост. | |
| host_name обязательно | Имя хоста в Zabbix. host_name является уникальным идентификатором и не может быть обновлён с помощью этого модуля. | |
| http_login_password (добавлено в 2.1) | Пароль Basic Auth | |
| http_login_user (добавлено в 2.1) | Логин Basic Auth | |
| interfaces | По умолчанию: [] | Список интерфейсов, которые необходимо создать для хоста (см. пример ниже). Доступные ключи: dns, ip, main, port, type, useip и bulk. Для получения дополнительной информации о поддерживаемых свойствах, обратитесь к документации по интерфейсам https://www.zabbix.com/documentation/2.0/manual/appendix/api/hostinterface/definitions#host_interface Если определение интерфейса неполное, этот модуль попытается заполнить разумные значения.
type также может быть agent, snmp, ipmi, или jmx вместо его числового значения. |
| inventory_mode (добавлено в 2.1) |
| Настройка режима инвентаризации. |
| inventory_zabbix (добавлено в 2.5) | Добавить данные для инвентаризации Zabbix (например, тег) (см. пример ниже). Для получения дополнительной информации о поддерживаемых свойствах, обратитесь к документации по интерфейсам https://www.zabbix.com/documentation/3.2/manual/api/reference/host/object#host_inventory | |
| ipmi_authtype (добавлено в 2.5) | Алгоритм аутентификации IPMI. Для получения дополнительной информации о поддерживаемых свойствах, обратитесь к документации по объекту хоста https://www.zabbix.com/documentation/3.4/manual/api/reference/host/object Возможные значения, 0 (нет), 1 (MD2), 2 (MD5), 4 (прямой), 5 (OEM), 6 (RMCP+), где -1 – значение по умолчанию API.Обратите внимание, что API Zabbix будет обрабатывать отсутствующие настройки как значения по умолчанию при обновлении любых из опций ipmi_; это означает, что если вы попытаетесь задать любое из четырёх параметров индивидуально, остальные будут сброшены до значений по умолчанию. | |
| ipmi_password (добавлено в 2.5) | Пароль IPMI. также см. последнее примечание в документации ipmi_authtype | |
| ipmi_privilege (добавлено в 2.5) | Уровень привилегий IPMI. Для получения дополнительной информации о поддерживаемых свойствах, обратитесь к документации по объекту хоста https://www.zabbix.com/documentation/3.4/manual/api/reference/host/object Возможные значения 1 (обратный вызов), 2 (пользователь), 3 (оператор), 4 (админ), 5 (OEM), где 2 – значение по умолчанию API.также см. последнее примечание в документации ipmi_authtype | |
| ipmi_username (добавлено в 2.5) | Имя пользователя IPMI. также см. последнее примечание в документации ipmi_authtype | |
| link_templates | Список шаблонов, связанных с хостом. | |
| login_password обязательно | Пароль пользователя Zabbix. | |
| login_user обязательно | Имя пользователя Zabbix. | |
| proxy | Имя прокси-сервера Zabbix, который необходимо использовать. | |
| server_url обязательно | URL сервера Zabbix с протоколом (http или https). url – псевдоним для server_url. псевдонимы: url | |
| state |
| Состояние хоста. В present, он будет создан, если хост не существует, или обновлён, если связанные данные отличаются.В absent будет удалён хост, если он существует. |
| status |
| Статус мониторинга хоста. |
| timeout | По умолчанию: 10 | Таймаут запроса API (секунды). |
| tls_accept (добавлено в 2.5) | По умолчанию: 1 | Определяет типы подключений, разрешённых для входящих соединений. Параметр tls_accept принимает значения от 1 до 7. Возможные значения: 1 (без шифрования), 2 (PSK), 4 (сертификат). Значения могут быть объединены. Работает только с Zabbix 3.0 и выше |
| tls_connect (добавлено в 2.5) | По умолчанию: 1 | Определяет тип шифрования для исходящих соединений. Возможные значения: 1 (без шифрования), 2 (PSK), 4 (сертификат). Работает только с Zabbix 3.0 и выше |
| tls_issuer (добавлено в 2.5) | Требуемый издатель сертификата. Работает только с Zabbix 3.0 и выше | |
| tls_psk (добавлено в 2.5) | Значение PSK – сложно угадываемая строка шестнадцатеричных цифр. Предварительно общаяя ключ, минимум 32 шестнадцатеричные цифры. Требуется, если tls_connect или tls_accept настроены на PSK. Работает только с Zabbix 3.0 и выше | |
| tls_psk_identity (добавлено в 2.5) | Уникальное имя, по которому Zabbix компоненты ссылаются на этот конкретный PSK Не вставляйте конфиденциальную информацию в строку идентификатора PSK, она передаётся по сети без шифрования. Работает только с Zabbix 3.0 и выше | |
| tls_subject (добавлено в 2.5) | Требуемый субъект сертификата. Работает только с Zabbix 3.0 и выше | |
| validate_certs bool (добавлено в 2.5) |
| Если значение равно False, SSL-сертификаты не будут проверены. Используйте только на контролируемых сайтах с самозаверяющимися сертификатами. |
| visible_name (добавлено в 2.3) | Видимое имя хоста в Zabbix. |
Примеры
- name: Create a new host or update an existing host's info
local_action:
module: zabbix_host
server_url: http://monitor.example.com
login_user: username
login_password: password
host_name: ExampleHost
visible_name: ExampleName
description: My ExampleHost Description
host_groups:
- Example group1
- Example group2
link_templates:
- Example template1
- Example template2
status: enabled
state: present
inventory_mode: manual
inventory_zabbix:
tag: "{{ your_tag }}"
alias: "{{ your_alias }}"
notes: "Special Informations: {{ your_informations | default('None') }}"
location: "{{ your_location }}"
site_rack: "{{ your_site_rack }}"
os: "{{ your_os }}"
hardware: "{{ your_hardware }}"
ipmi_authtype: 2
ipmi_privilege: 4
ipmi_username: username
ipmi_password: password
interfaces:
- type: 1
main: 1
useip: 1
ip: 10.xx.xx.xx
dns: ""
port: 10050
- type: 4
main: 1
useip: 1
ip: 10.xx.xx.xx
dns: ""
port: 12345
proxy: a.zabbix.proxy
- name: Update an existing host's TLS settings
local_action:
module: zabbix_host
server_url: http://monitor.example.com
login_user: username
login_password: password
host_name: ExampleHost
visible_name: ExampleName
host_groups:
- Example group1
tls_psk_identity: test
tls_connect: 2
tls_psk: 123456789abcdef123456789abcdef12
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Для получения дополнительной информации см. Техническое обслуживание и поддержка модулей.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- (@cove)
- Tony Minfei Ding
- Harrison Gu (@harrisongu)
- Werner Dijkerman
- Eike Frost (@eikef)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/zabbix_host_module.html
