nios_aaaa_record – Настройка записей AAAA Infoblox NIOS

Новая версия 2.6.

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

Обзор

Добавляет и/или удаляет экземпляры объектов записей AAAA из серверов Infoblox NIOS. Этот модуль управляет объектами NIOS record:aaaa с использованием интерфейса Infoblox WAPI через REST.

Требования

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

infoblox-client

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
comment -			Настраивает текстовую строку комментария, которая будет связана с экземпляром этого объекта. Предоставленная текстовая строка будет настроена в экземпляре объекта.
extattrs -			Позволяет настроить расширенные атрибуты на экземпляре объекта. Этот аргумент принимает набор пар «ключ/значение» для настройки.
ipv6addr - / обязательно			Настраивает IPv6-адрес для этой записи AAAA. псевдонимы: ipv6
name - / обязательно			Указывает полное доменное имя для добавления или удаления из системы
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 -		Варианты: present ← absent	Настраивает требуемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в `present`, объект настраивается на устройстве, а когда это значение установлено в `absent`, значение удаляется (при необходимости) с устройства.
ttl -			Настраивает TTL для этой записи AAAA.
view - / обязательно		По умолчанию: "default"	Устанавливает DNS-зону для ассоциации с этой записью AAAA. DNS-зона должна быть уже настроена в системе. псевдонимы: dns_view

Примечания

Примечание

Этот модуль должен выполняться локально, что можно сделать, указав connection: local.
Для получения более подробной информации об использовании Infoblox с Ansible обратитесь к руководству Infoblox.

Примеры

- name: configure an AAAA record
  nios_aaaa_record:
    name: aaaa.ansible.com
    ipv6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: add a comment to an existing AAAA record
  nios_aaaa_record:
    name: aaaa.ansible.com
    ipv6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: remove an AAAA record from the system
  nios_aaaa_record:
    name: aaaa.ansible.com
    ipv6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: update an AAAA record name
  nios_aaaa_record:
    name: {new_name: aaaa_new.ansible.com, old_name: aaaa.ansible.com}
    ipv6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается партнером Ansible. [сертифицировано]

Авторы

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.9/modules/nios_aaaa_record_module.html