Модуль infoblox.nios_modules.nios_nsgroup_forwardingmember — настройка групп участников пересылки DNS-серверов имён Infoblox

Примечание

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

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

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

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

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

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

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

Добавляет и/или удаляет группы серверов имён типа «Участник пересылки» на серверах Infoblox NIOS. Этот модуль управляет объектами NIOS nsgroup:forwardstubserver через интерфейс Infoblox WAPI по REST.

Требования

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

infoblox_client

Параметры

Параметр	Комментарии
comment string	Настраивает текстовый комментарий, связанный с экземпляром этого объекта. Указанный текст будет задан для экземпляра объекта.
extattrs dictionary	Позволяет настраивать расширяемые атрибуты экземпляра объекта. Этот аргумент принимает набор пар «ключ / значение» для настройки.
forwarding_servers list / elements=dictionary / обязательный	Задает список серверов — участников пересылки, которые будут использоваться
forward_to list / elements=dictionary	Информация об удалённом сервере имён, на который устройство Infoblox должно пересылать запросы для указанного доменного имени. По умолчанию: `[]`
address string / обязательный	Укажите IP-адрес сервера
name string / обязательный	Укажите имя сервера
forwarders_only boolean	Определяет, отправляет ли устройство запросы только серверам пересылки, а не другим внутренним или корневым интернет-серверам. Варианты: `false` ← (по умолчанию) `true`
name string / обязательный	Имя участника grid для пересылки в формате FQDN
use_override_forwarders boolean	При использовании параметра c(forward_to), если задано значение `True`, будут использоваться только указанные пользовательские серверы пересылки (без рекурсивного обращения к корневым серверам имён). Варианты: `false` ← (по умолчанию) `true`
name string / обязательный	Задает имя группы серверов имён NIOS, которой требуется управлять.
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"`
state string	Задает требуемое состояние экземпляра объекта на сервере NIOS. Если для этого параметра задано значение `present`, объект настраивается на устройстве; если задано значение `absent`, объект удаляется с устройства (если необходимо). Варианты: `"present"` ← (по умолчанию) `"absent"`

Примечания

Примечание

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

Примеры

- name: create infoblox nameserver forwarding member group
  infoblox.nios_modules.nios_nsgroup_forwardingmember:
    name: my-forwardingmember-group
    comment: "this is a forwarding member nameserver group"
    forwarding_servers:
      - name: member.localdomain
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: create infoblox nameserver forwarding member group with external forwarders
  infoblox.nios_modules.nios_nsgroup_forwardingmember:
    name: my-forwardingmember-group
    comment: "this is a forwarding member nameserver group with external forwarders"
    forwarding_servers:
      - name: member.localdomain
        use_override_forwarders: true
        forward_to:
          - name: ns1
            address: 192.168.10.1
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

Mauricio Teixeira (@badnetmask)

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

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