Модуль community.zabbix.zabbix_autoregister — обновление авто регистрации Zabbix

Примечание

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

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

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

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

Добавлено в community.zabbix 1.6.0

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

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

Этот модуль позволяет изменять параметры авто регистрации Zabbix.

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
http_login_password string	Пароль для базовой аутентификации
http_login_user string	Имя пользователя для базовой аутентификации
tls_accept list / elements=string / обязательный	Тип разрешённых входящих подключений для авто регистрации. Выберите `unsecure`, `tls_with_psk` или оба варианта.
tls_psk string	Для TLS-подключения используется это значение PSK. Если текущее значение tls_accept — `unsecure`, для этого параметра необходимо задать значение tls_accept=tls_with_psk.
tls_psk_identity string	Для TLS-подключения используется эта строка идентификатора PSK. Строка идентификатора PSK передаётся по сети в незашифрованном виде. Поэтому не указывайте здесь конфиденциальную информацию. Если текущее значение tls_accept — `unsecure`, для этого параметра необходимо задать значение tls_accept=tls_with_psk.

Примечания

Примечание

Этот модуль возвращает changed=true, если для tls_psk_identity или tls_psk задано какое-либо значение, поскольку API Zabbix не возвращает конфиденциальные данные, которые модуль мог бы использовать для сравнения.
Обратите внимание, что этот модуль настраивает глобальные параметры сервера Zabbix. Чтобы создать действие авто регистрации, позволяющее узлам автоматически добавлять себя в систему мониторинга, см. community.zabbix.zabbix_action.

Примеры

# 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

- name: Update autoregistration
  # 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_autoregister:
    tls_accept:
      - unsecure
      - tls_with_psk
    tls_psk_identity: "PSK 001"
    tls_psk: "11111595725ac58dd977beef14b97461a7c1045b9a1c923453302c5473193478"

- name: Set unsecure to tls_accept
  # 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_autoregister:
    tls_accept: unsecure

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

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

Ключ	Описание
msg string	Результат операции Возвращается: при успешном выполнении Пример: `"Successfully updated global autoregistration setting"`

Авторы

ONODERA Masaru(@masa-orca)

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

© 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_autoregister_module.html