community.zabbix.zabbix_usergroup – Создание/удаление/обновление групп пользователей Zabbix

Примечание

Этот плагин входит в коллекцию community.zabbix (версия 1.1.0).

Для его установки используйте: ansible-galaxy collection install community.zabbix.

Для использования в плейбуке укажите: community.zabbix.zabbix_usergroup.

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

Описание

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

Требования

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

zabbix-api >= 0.5.4

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
debug_mode строка		Варианты: disabled ← enabled	Включен или выключен режим отладки.
gui_access строка		Варианты: default ← internal LDAP disable	Метод аутентификации пользователей в группе для фронтального интерфейса. Возможные значения: default - использование системного метода аутентификации; internal - использование внутренней аутентификации; LDAP - использование аутентификации LDAP; disable - отключение доступа к фронтальному интерфейсу.
http_login_password строка			Пароль для аутентификации Basic Auth
http_login_user строка			Логин для аутентификации Basic Auth
login_password строка / обязательно			Пароль пользователя Zabbix.
login_user строка / обязательно			Имя пользователя Zabbix.
name строка / обязательно			Имя группы пользователей для создания, обновления или удаления. псевдонимы: user_group
rights список / элементы=словарь			Права, которые нужно назначить группе
	host_group строка / обязательно		Имя группы хостов, к которой добавляются права.
	permission строка / обязательно	Варианты: denied read-only read-write	Уровень доступа к группе хостов.
server_url строка / обязательно			URL сервера Zabbix, с протоколом (http или https). `url` является псевдонимом `server_url`. псевдонимы: url
state строка		Варианты: present ← absent	Состояние группы пользователей. В `present`, он создаст, если группа пользователей не существует, или обновит группу пользователей, если связанные данные отличаются. В `absent` будет удалена группа пользователей, если она существует.
status строка		Варианты: enabled ← disabled	Включена или выключена группа пользователей.
tag_filters список / элементы=словарь			Права на основе тегов для назначения группе.
	host_group строка / обязательно		Имя группы хостов, к которой добавляются права.
	tag строка	По умолчанию: ""	Имя тега.
	value строка	По умолчанию: ""	Значение тега.
timeout целое число		По умолчанию: 10	Время ожидания запроса API (секунды).
validate_certs булево		Варианты: no yes ←	Если установлено в False, сертификаты SSL не будут проверены. Это следует использовать только на управляемых вами сайтах, использующих самоподписанные сертификаты.

Примечания

Примечание

Поддерживается только Zabbix >= 4.0.
Если вы используете login_password=zabbix, слово “zabbix” заменяется на “****” во всех выходных данных модуля, потому что login_password использует no_log. См. этот FAQ для получения дополнительной информации.

Примеры

# Base create user group example
- name: Create user group
  community.zabbix.zabbix_usergroup:
    server_url: "http://zabbix.example.com/zabbix/"
    login_user: admin
    login_password: secret
    name: ACME
    state: present

# Base create user group with disabled gui access
- name: Create user group with disabled gui access
  community.zabbix.zabbix_usergroup:
    server_url: "http://zabbix.example.com/zabbix/"
    login_user: admin
    login_password: secret
    name: ACME
    gui_access: disable

# Base create user group with permissions
- name: Create user group with permissions
  community.zabbix.zabbix_usergroup:
    server_url: "http://zabbix.example.com/zabbix/"
    login_user: admin
    login_password: secret
    name: ACME
    rights:
        - host_group: Webserver
          permission: read-write
        - host_group: Databaseserver
          permission: read-only
    state: present

# Base create user group with tag permissions
- name: Create user group with tag permissions
  community.zabbix.zabbix_usergroup:
    server_url: "http://zabbix.example.com/zabbix/"
    login_user: admin
    login_password: secret
    name: ACME
    tag_filters:
        - host_group: Webserver
          tag: Application
          value: Java
        - host_group: Discovered hosts
          tag: Service
          value: JIRA
    state: present

# Base delete user groups example
- name: Delete user groups
  community.zabbix.zabbix_usergroup:
    server_url: "http://zabbix.example.com/zabbix/"
    login_user: admin
    login_password: secret
    name: ACME
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
msg строка	всегда	Результат операции Пример: Группа пользователей создана: ACME, ID: 42
state строка	при успехе	Состояние группы пользователей в конце выполнения. Пример: present
usergroup строка	при успехе	Имя группы пользователей. Пример: ACME
usrgrpid строка	при успехе	Идентификатор группы пользователей, если она была создана, изменена или удалена. Пример: 42

Авторы

Tobias Birkefeld (@tcraxs)

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