Модуль community.zabbix.zabbix_templategroup — создание/удаление групп шаблонов Zabbix

Примечание

Этот модуль входит в коллекцию community.zabbix (версия 4.2.0).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.zabbix. Для работы с этим модулем требуются дополнительные компоненты. Подробнее см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.zabbix.zabbix_templategroup.

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

Создаёт группы шаблонов, если они не существуют.
Удаляет существующие группы шаблонов.

Требования

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

python >= 2.6

Параметры

Параметр	Комментарии
http_login_password string	Пароль для базовой аутентификации
http_login_user string	Имя пользователя для базовой аутентификации
propagate dictionary	Список настроек, которые будут распространены. После создания отсутствующих групп шаблонов этот модуль распространяет разрешения. Этот параметр предназначен для Zabbix >= 7.0.
permissions boolean	Если задано значение `true`, разрешения будут распространены. Варианты: `false` ← (по умолчанию) `true`
state string	Создать или удалить группу шаблонов. Варианты: `"present"` ← (по умолчанию) `"absent"`
template_groups псевдонимы: template_group list / элементы=string / обязательный	Список групп шаблонов для создания или удаления.

Примечания

Примечание

Слишком большое количество одновременных обновлений одной и той же группы может привести к ошибкам Zabbix. При необходимости см. примеры, в которых описан способ обхода этой проблемы.

Примеры

# If you want to use Username and Password to be authenticated by Zabbix Server
- name: Set credentials to access Zabbix Server API
  ansible.builtin.set_fact:
    ansible_user: Admin
    ansible_httpapi_pass: zabbix

# If you want to use API token to be authenticated by Zabbix Server
# https://www.zabbix.com/documentation/current/en/manual/web_interface/frontend_sections/administration/general#api-tokens
- name: Set API token
  ansible.builtin.set_fact:
    ansible_zabbix_auth_key: 8ec0d52432c15c91fcafe9888500cf9a607f44091ab554dbee860f6b44fac895

# Base create template groups example
- name: Create template groups
  # set task level variables as we change ansible_connection plugin here
  vars:
    ansible_network_os: community.zabbix.zabbix
    ansible_connection: httpapi
    ansible_httpapi_port: 443
    ansible_httpapi_use_ssl: true
    ansible_httpapi_validate_certs: false
    ansible_zabbix_url_path: 'zabbixeu'  # If Zabbix WebUI runs on non-default (zabbix) path ,e.g. http://<FQDN>/zabbixeu
    ansible_host: zabbix-example-fqdn.org
  community.zabbix.zabbix_templategroup:
    state: present
    template_groups:
      - Example group1
      - Example group2

# Limit the Zabbix group creations to one template since Zabbix can return an error when doing concurrent updates
- name: Create template groups
  # set task level variables as we change ansible_connection plugin here
  vars:
      ansible_network_os: community.zabbix.zabbix
      ansible_connection: httpapi
      ansible_httpapi_port: 443
      ansible_httpapi_use_ssl: true
      ansible_httpapi_validate_certs: false
      ansible_zabbix_url_path: 'zabbixeu'  # If Zabbix WebUI runs on non-default (zabbix) path ,e.g. http://<FQDN>/zabbixeu
      ansible_host: zabbix-example-fqdn.org
  community.zabbix.zabbix_templategroup:
    state: present
    template_groups:
      - Example group1
      - Example group2
  when: inventory_hostname==groups['group_name'][0]

- name: Propagate permissions to sub template group
  vars:
    ansible_network_os: community.zabbix.zabbix
    ansible_connection: httpapi
    ansible_httpapi_port: 443
    ansible_httpapi_use_ssl: true
    ansible_httpapi_validate_certs: false
    ansible_zabbix_url_path: 'zabbixeu'
    ansible_host: zabbix-example-fqdn.org
  community.zabbix.zabbix_templategroup:
    state: present
    template_groups:
      - Example group1
    propagate:
      permissions: true

Авторы

Cove (@cove)
Tony Minfei Ding
Harrison Gu (@harrisongu)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/zabbix/zabbix_templategroup_module.html