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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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 строка	Пароль для базовой аутентификации
http_login_user строка	Логин для базовой аутентификации
tls_accept список / элементы=строка / обязательный	Тип разрешенных входящих подключений для авторегистрации. Выберите из `unsecure`, `tls_with_psk` или оба.
tls_psk строка	TLS подключение использует это значение PSK. Это значение требует tls_accept=tls_with_psk, если текущее значение tls_accept равно `unsecure`.
tls_psk_identity строка	TLS подключение использует эту строку идентификатора PSK. Строка идентификатора PSK будет передаваться по сети без шифрования. Поэтому вы не должны включать сюда конфиденциальную информацию. Это значение требует tls_accept=tls_with_psk, если текущее значение tls_accept равно `unsecure`.

Примечания

Примечание

Этот модуль возвращает 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 строка	Результат операции Возвращено: success Пример: `"Successfully updated global autoregistration setting"`

Авторы

ONODERA Masaru(@masa-orca)

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

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