zabbix_template - создание/удаление/экспорт шаблона zabbix

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

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

Описание

Создание/удаление/экспорт шаблона zabbix

Требования

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

python >= 2.6
zabbix-api >= 0.5.3

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
clear_templates		Список шаблонов, очищаемых из шаблона. см. templates_clear в https://www.zabbix.com/documentation/3.0/manual/api/reference/template/update
http_login_password (добавлено в 2.1)	Значение по умолчанию: None	Пароль для аутентификации Basic Auth
http_login_user (добавлено в 2.1)	Значение по умолчанию: None	Имя пользователя для аутентификации Basic Auth
link_templates		Список шаблонов, связанных с шаблоном.
login_password обязательно		Пароль пользователя Zabbix.
login_user обязательно		Имя пользователя Zabbix.
macros		Список макросов шаблона.
server_url обязательно		URL сервера Zabbix с протоколом (http или https). `url` — псевдоним для `server_url`. Псевдонимы: url
state	Варианты: present ← absent dump	Состояние present создаёт/обновляет шаблон, absent удаляет шаблон.
template_groups		Список групп шаблонов для создания или удаления.
template_json		JSON экспорт шаблона для импорта
template_name обязательно		Имя шаблона zabbix
timeout	Значение по умолчанию: 10	Время ожидания запроса API (в секундах).
validate_certs (добавлено в 2.5)	Варианты: true false Значение по умолчанию: yes	Если установлено в False, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых лично сайтах, использующих самозаверяющие сертификаты.

Примеры

---
# Creates a new zabbix template from linked template
- name: Create Zabbix template using linked template
  local_action:
    module: zabbix_template
    server_url: http://127.0.0.1
    login_user: username
    login_password: password
    template_name: ExampleHost
    template_json: "{'zabbix_export': {}}"
    template_groups:
      - Role
      - Role2
    link_templates:
      - Example template1
      - Example template2
    clear_templates:
      - Example template3
      - Example template4
    macros:
      - macro: '{$EXAMPLE_MACRO1}'
        value: 30000
      - macro: '{$EXAMPLE_MACRO2}'
        value: 3
      - macro: '{$EXAMPLE_MACRO3}'
        value: 'Example'
    state: present

# Create a new template from a json config definition
- name: Import Zabbix json template configuration
  local_action:
    module: zabbix_template
    server_url: http://127.0.0.1
    login_user: username
    login_password: password
    template_name: Apache2
    template_json: "{{ lookup('file', 'zabbix_apache2.json') }}"
    template_groups:
      - Webservers
    state: present

# Import a template from Ansible variable dict
- name: Import Zabbix Template
  zabbix_template:
    login_user: username
    login_password: password
    server_url: http://127.0.0.1
    template_name: Test Template
    template_json:
        zabbix_export:
        version: '3.2'
        templates:
          - name: Template for Testing
            description: 'Testing template import'
            template: Test Template
            groups:
              - name: Templates
            applications:
              - name: Test Application
    template_groups: Templates
    state: present

# Add a macro to a template
- name: Set a macro on the Zabbix template
  local_action:
    module: zabbix_template
    server_url: http://127.0.0.1
    login_user: username
    login_password: password
    template_name: Template
    macros:
      - macro: '{$TEST_MACRO}'
        value: 'Example'
    state: present

# Remove a template
- name: Delete Zabbix template
  local_action:
    module: zabbix_template
    server_url: http://127.0.0.1
    login_user: username
    login_password: password
    template_name: Template
    state: absent

# Export template json definition
- name: Dump Zabbix template
  local_action:
    module: zabbix_template
    server_url: http://127.0.0.1
    login_user: username
    login_password: password
    template_name: Template
    state: dump
  register: template_dump

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

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

Ключ	Возвращаемое значение	Описание
template_json строка	при state = dump	JSON экспорт шаблона Пример: {'zabbix_export': {'date': '2017-11-29T16:37:24Z', 'templates': [{'templates': [], 'description': '', 'applications': [], 'items': [], 'httptests': [], 'name': 'Тестовый шаблон', 'screens': [], 'macros': [], 'discovery_rules': [], 'groups': [{'name': 'Шаблоны'}], 'template': 'test'}], 'version': '3.2', 'groups': [{'name': 'Шаблоны'}]}}

Статус

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

Автор

@sookido
Logan Vig (@logan2211)

Подсказка

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

© 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/zabbix_template_module.html