Модуль infoblox.nios_modules.nios_dtc_monitor_snmp — настройка мониторов SNMP DTC Infoblox NIOS

Примечание

Этот модуль входит в коллекцию infoblox.nios_modules (версия 1.9.0).

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

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

Чтобы использовать его в плейбуке, укажите: infoblox.nios_modules.nios_dtc_monitor_snmp.

Добавлено в infoblox.nios_modules 1.6.0

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

Обзор

Добавляет и/или удаляет экземпляры объектов монитора DTC SNMP на серверах Infoblox NIOS. Этот модуль управляет объектами dtc:monitor:snmp через интерфейс Infoblox WAPI по REST.

Требования

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

infoblox-client

Параметры

Параметр	Описание
comment string	Задаёт текстовый комментарий, связанный с экземпляром этого объекта. Указанный текст будет добавлен к экземпляру объекта.
community string	Задаёт строку сообщества SNMP для аутентификации SNMP. По умолчанию: `"public"`
context string	Задаёт контекст SNMPv3. Значения с пробелами в начале или конце недопустимы для этого поля.
engine_id string	Задаёт идентификатор механизма SNMPv3. Значения с пробелами в начале или конце недопустимы для этого поля.
extattrs dictionary	Позволяет настроить расширяемые атрибуты для экземпляра объекта. Этот аргумент принимает набор пар «ключ / значение» для настройки.
interval integer	Задаёт интервал проверки работоспособности SNMP. По умолчанию: `5`
name string / обязательный	Задаёт отображаемое имя этого монитора DTC. Значения с пробелами в начале или конце недопустимы для этого поля.
oids list / элементы=dictionary	Задаёт список OID для мониторинга SNMP.
comment string	Задаёт текстовый комментарий, связанный с экземпляром этого объекта. Указанный текст будет добавлен к экземпляру объекта.
condition string	Задаёт условие проверки результата проверки работоспособности SNMP. Варианты: `"ANY"` ← (по умолчанию) `"EXACT"` `"GEQ"` `"LEQ"` `"RANGE"`
first string	Задаёт первый член условия для сопоставления с результатом проверки работоспособности SNMP.
last string	Задаёт второй член условия для сопоставления с результатом проверки работоспособности SNMP при условии «RANGE».
oid string / обязательный	Задаёт значение OID SNMP для проверок работоспособности монитора DTC SNMP. Это поле обязательно при создании
type string	Задаёт тип условия для результатов проверок работоспособности монитора DTC SNMP. Варианты: `"INTEGER"` `"STRING"` ← (по умолчанию)
port integer	Задаёт номер порта для запросов SNMP. По умолчанию: `161`
provider dictionary	Словарь с параметрами подключения.
cert string	Указывает файл сертификата клиента с дайджестом конфигурации x509 для дополнительного уровня защиты соединения с удалённым экземпляром NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_CERT`.
host string	Указывает DNS-имя или адрес хоста для подключения к удалённому экземпляру NIOS WAPI по REST. Значение также можно задать с помощью переменной окружения `INFOBLOX_HOST`.
http_pool_connections integer	Вставьте описание здесь По умолчанию: `10`
http_pool_maxsize integer	Вставьте описание здесь По умолчанию: `10`
http_request_timeout integer	Время ожидания ответа перед истечением срока ожидания Значение также можно задать с помощью переменной окружения `INFOBLOX_HTTP_REQUEST_TIMEOUT`. По умолчанию: `10`
key string	Указывает файл закрытого ключа для шифрования сертификатом при подключении к удалённому экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_KEY`.
max_results integer	Указывает максимальное количество возвращаемых объектов. Если задано отрицательное число, устройство вернёт ошибку, когда количество возвращаемых объектов превысит заданное значение. Значение также можно задать с помощью переменной окружения `INFOBLOX_MAX_RESULTS`. По умолчанию: `1000`
max_retries integer	Задаёт количество повторных попыток подключения до того, как соединение будет признано пригодным для использования. Значение также можно задать с помощью переменной окружения `INFOBLOX_MAX_RETRIES`. По умолчанию: `3`
password string	Указывает пароль для аутентификации подключения к удалённому экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_PASSWORD`.
silent_ssl_warnings boolean	Вставьте описание здесь Варианты: `false` `true` ← (по умолчанию)
username string	Задаёт имя пользователя для аутентификации подключения к удалённому экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_USERNAME`.
validate_certs псевдонимы: ssl_verify boolean	Логическое значение для включения или отключения проверки SSL-сертификатов. Значение также можно задать с помощью переменной окружения `INFOBLOX_SSL_VERIFY`. Варианты: `false` ← (по умолчанию) `true`
wapi_version string	Указывает версию WAPI, которую следует использовать. Значение также можно задать с помощью переменной окружения `INFOBLOX_WAPI_VERSION`. До Ansible 2.8 версией WAPI по умолчанию была 1.4 По умолчанию: `"2.12.3"`
retry_down integer	Задаёт количество проверок, при котором сервер, ранее работавший, должен отображаться как недоступный, чтобы считаться неработоспособным. По умолчанию: `1`
retry_up integer	Задаёт количество проверок, при котором сервер, ранее не работавший, должен отображаться как доступный, чтобы считаться работоспособным. По умолчанию: `1`
state string	Задаёт требуемое состояние экземпляра объекта на сервере NIOS. Если задано значение `present`, объект будет настроен на устройстве; если задано значение `absent`, объект будет удалён с устройства (при необходимости). Варианты: `"present"` ← (по умолчанию) `"absent"`
timeout integer	Задаёт время ожидания проверки работоспособности SNMP в секундах. По умолчанию: `15`
user string	Задаёт параметры пользователя SNMPv3.
version string	Задаёт версию протокола SNMP для проверки работоспособности SNMP. Варианты: `"V1"` `"V2C"` ← (по умолчанию) `"V3"`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Модуль необходимо запускать локально. Для этого можно указать connection: local.
Дополнительные сведения об использовании Infoblox с Ansible см. в руководстве :ref:`nios_guide`.

Примеры

- name: Configure a DTC SNMP monitor
  infoblox.nios_modules.nios_dtc_monitor_snmp:
    name: snmp_monitor
    port: 8080
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Add a comment to an existing DTC SNMP monitor
  infoblox.nios_modules.nios_dtc_monitor_snmp:
    name: snmp_monitor
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove a DTC SNMP monitor from the system
  infoblox.nios_modules.nios_dtc_monitor_snmp:
    name: snmp_monitor
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

Joachim Buyse (@jbisabel)

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

© 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/infoblox/nios_modules/nios_dtc_monitor_snmp_module.html