community.general.nios_srv_record – Настройка записей SRV Infoblox NIOS
Примечание
Этот плагин является частью коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в playbook, укажите: community.general.nios_srv_record.
Краткое описание
- Добавляет и/или удаляет экземпляры объектов записи SRV с серверов Infoblox NIOS. Этот модуль управляет объектами NIOS
record:srvс использованием интерфейса Infoblox WAPI через REST.
Требования
Следующие требования необходимы на хосте, который выполняет этот модуль.
- infoblox-client
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| comment строка | Настраивает текстовый комментарий, который будет связан с экземпляром этого объекта. Предоставленная текстовая строка будет настроена в экземпляре объекта. | ||
| extattrs строка | Позволяет настраивать расширяемые атрибуты в экземпляре объекта. Этот аргумент принимает набор пар ключ/значение для настройки. | ||
| name строка / обязательно | Указывает полное доменное имя, которое нужно добавить или удалить из системы | ||
| port строка | Настраивает порт (0-65535) этой записи SRV. | ||
| priority строка | Настраивает приоритет (0-65535) для этой записи SRV. | ||
| provider словарь | Объект словаря, содержащий данные подключения. | ||
| host строка | Указывает имя DNS-хоста или адрес для подключения к удаленному экземпляру NIOS WAPI через REST Значение также может быть указано с помощью переменной среды INFOBLOX_HOST. | ||
| http_request_timeout целое число | По умолчанию: 10 | Время ожидания ответа Значение также может быть указано с помощью переменной среды INFOBLOX_HTTP_REQUEST_TIMEOUT. | |
| max_results целое число | По умолчанию: 1000 | Указывает максимальное количество объектов, которые будут возвращены; если установлено отрицательное число, устройство вернет ошибку, когда количество возвращаемых объектов превысит это значение. Значение также может быть указано с помощью переменной среды INFOBLOX_MAX_RESULTS. | |
| max_retries целое число | По умолчанию: 3 | Настраивает количество попыток повторного подключения перед объявлением подключения работоспособным Значение также может быть указано с помощью переменной среды INFOBLOX_MAX_RETRIES. | |
| password строка | Указывает пароль для аутентификации подключения к удаленному экземпляру NIOS. Значение также может быть указано с помощью переменной среды INFOBLOX_PASSWORD. | ||
| username строка | Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также может быть указано с помощью переменной среды INFOBLOX_USERNAME. | ||
| validate_certs логическое |
| Логическое значение для включения или отключения проверки SSL-сертификатов Значение также может быть указано с помощью переменной среды INFOBLOX_SSL_VERIFY.псевдонимы: ssl_verify | |
| wapi_version строка | По умолчанию: "2.1" | Указывает версию WAPI для использования Значение также может быть указано с помощью переменной среды INFOBLOX_WAP_VERSION.До Ansible 2.8 версией WAPI по умолчанию была 1.4 | |
| state строка |
| Настраивает требуемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в present, объект настраивается на устройстве, а когда это значение установлено в absent, значение удаляется (при необходимости) с устройства. | |
| target строка | Настраивает целевое FQDN для этой записи SRV. | ||
| ttl строка | Настраивает TTL, который будет связан с этой записью хоста | ||
| view строка | По умолчанию: "default" | Устанавливает DNS-представление для связывания с этой записью. DNS-представление должно быть уже настроено в системе псевдонимы: dns_view | |
| weight строка | Настраивает вес (0-65535) для этой записи SRV. | ||
Примечания
Примечание
- Этот модуль должен запускаться локально, чего можно добиться, указав
connection: local. - Пожалуйста, прочитайте Руководство по Infoblox для получения более подробной информации о том, как использовать Infoblox с Ansible.
Примеры
- name: Configure an SRV record
community.general.nios_srv_record:
name: _sip._tcp.service.ansible.com
port: 5080
priority: 10
target: service1.ansible.com
weight: 10
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: Add a comment to an existing SRV record
community.general.nios_srv_record:
name: _sip._tcp.service.ansible.com
port: 5080
priority: 10
target: service1.ansible.com
weight: 10
comment: this is a test comment
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: Remove an SRV record from the system
community.general.nios_srv_record:
name: _sip._tcp.service.ansible.com
port: 5080
priority: 10
target: service1.ansible.com
weight: 10
state: absent
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
Авторы
- Blair Rampling (@brampling)
© 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/general/nios_srv_record_module.html