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)		Пароль Basic Auth
http_login_user (добавлено в 2.1)		Логин 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 bool (добавлено в 2.5)	Варианты: no 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': '', 'httptests': [], 'screens': [], 'applications': [], 'discovery_rules': [], 'groups': [{'name': 'Templates'}], 'name': 'Test Template', 'items': [], 'macros': [], 'template': 'test'}], 'version': '3.2', 'groups': [{'name': 'Templates'}]}}

Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Поддержка и техническое обслуживание модулей для получения дополнительной информации.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

@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.6/modules/zabbix_template_module.html