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

Примечание

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

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

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

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

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Создание групп узлов, если они не существуют.
Удаление существующих групп узлов.

Требования

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

python >= 2.6

Параметры

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

Примечания

Примечание

Слишком большое количество одновременных обновлений одной и той же группы может привести к ошибкам 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 host groups example
- name: Create host 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_group:
    state: present
    host_groups:
      - Example group1
      - Example group2

# Limit the Zabbix group creations to one host since Zabbix can return an error when doing concurrent updates
- name: Create host 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_group:
    state: present
    host_groups:
      - Example group1
      - Example group2
  when: inventory_hostname==groups['group_name'][0]

- name: Propagate permissions to sub group (Zabbix >= 7.0)
  # 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_group:
    state: present
    host_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_group_module.html