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

Примечание

Этот модуль входит в коллекцию 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_sip.

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

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

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

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

Требования

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

infoblox-client

Параметры

Параметр	Описание
ciphers string	Задает необязательный список шифров для защищенного соединения TLS/SIPS.
client_cert string	Задает необязательный сертификат клиента, который используется при наличии в режиме TLS или SIPS.
comment string	Задает текстовый комментарий, связанный с экземпляром этого объекта. Указанная текстовая строка будет сохранена в экземпляре объекта.
extattrs dictionary	Позволяет настроить расширяемые атрибуты для экземпляра объекта. Этот аргумент принимает набор пар «ключ/значение» для настройки.
interval integer	Задает интервал проверки работоспособности SIP. По умолчанию: `5`
name string / обязательный	Задает отображаемое имя этого монитора DTC. Значения с пробелами в начале или конце недопустимы для этого поля.
port integer	Задает номер порта для SIP-запросов. По умолчанию: `5060`
provider dictionary	Объект dict, содержащий сведения о подключении.
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"`
request string	Задает отправляемый SIP-запрос
result string	Задает тип ожидаемого результата Варианты: `"ANY"` ← (по умолчанию) `"CODE_IS"` `"CODE_IS_NOT"`
result_code integer	Задает ожидаемый код возврата По умолчанию: `200`
retry_down integer	Задает количество проверок, при котором сервер, считавшийся доступным, будет признан неработающим. По умолчанию: `1`
retry_up integer	Задает количество проверок, при котором сервер, считавшийся неработающим, будет признан доступным. По умолчанию: `1`
state string	Задает требуемое состояние экземпляра объекта на сервере NIOS. Если значение равно `present`, объект будет настроен на устройстве; если значение равно `absent`, объект будет удален с устройства (при необходимости). Варианты: `"present"` ← (по умолчанию) `"absent"`
timeout integer	Задает время ожидания проверки работоспособности SIP в секундах. По умолчанию: `15`
transport string	Задает протокол транспортного уровня для проверки SIP Варианты: `"SIPS"` `"TCP"` ← (по умолчанию) `"TLS"` `"UDP"`
validate_cert boolean	Задает, включена ли проверка сертификата удаленного сервера. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Configure a DTC SIP monitor
  infoblox.nios_modules.nios_dtc_monitor_sip:
    name: sip_monitor
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

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

- name: Remove a DTC SIP monitor from the system
  infoblox.nios_modules.nios_dtc_monitor_sip:
    name: sip_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_sip_module.html