Модуль netapp.ontap.na_ontap_dns — создание, удаление и изменение DNS-серверов NetApp ONTAP.

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 23.5.0).

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

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

Чтобы использовать его в плейбуке, укажите: netapp.ontap.na_ontap_dns.

Добавлено в netapp.ontap 2.7.0

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

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

Создание, удаление и изменение DNS-серверов.
При использовании REST модуль в настоящее время поддерживает операции удаления и изменения только для SVM данных.

Требования

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

Ansible 2.9 или более поздней версии; рекомендуется версия 2.12 или более поздняя.
Python3; рекомендуется версия 3.9 или более поздняя.
netapp-lib требуется только при использовании ZAPI (установите с помощью «pip install netapp-lib»). Обратите внимание, что netapp-lib устарела и больше не поддерживается. Используйте на свой страх и риск.
Физическая или виртуальная кластерная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии; для поддержки REST требуется ONTAP 9.6 или более поздняя версия.

Параметры

Параметр	Комментарии
cert_filepath строка добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
domains список / элементы=строка	Список DNS-доменов, например ‘sales.bar.com’. Первый домен — это домен, к которому принадлежит Vserver.
feature_flags словарь добавлено в netapp.ontap 20.5.0	Включение или отключение новой функции. Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут изменяться без предварительного уведомления. Неизвестные ключи игнорируются.
force_ontap_version строка добавлено в netapp.ontap 21.23.0	Переопределение версии ONTAP кластера при использовании REST. Если версия не соответствует целевому кластеру, поведение не определено. Этот параметр предоставляется в качестве обходного решения, если версию кластера невозможно прочитать из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Значение должно иметь формат 9.10 или 9.10.1, где каждый компонент является целым числом. Если для `use_rest` задано значение auto, это может привести к переключению на ZAPI в зависимости от версии и возможностей платформы. Игнорируется при использовании ZAPI.
hostname строка / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределение порта по умолчанию (80 или 443).
https логический	Включение и отключение https. Игнорируется при использовании REST, поскольку поддерживается только https. Игнорируется при использовании аутентификации с помощью SSL-сертификата, поскольку для нее требуется SSL. Варианты: `false` ← (по умолчанию) `true`
key_filepath строка добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
lambda_config словарь добавлено в netapp.ontap 23.5.0	Параметры конфигурации функциональности прокси-сервера AWS Lambda. Этот параметр и его вложенные параметры поддерживаются только при использовании REST.
aws_profile строка	Имя профиля AWS, используемого для аутентификации.
aws_region строка / обязательный	Название региона AWS.
function_name строка / обязательный	Имя вызываемой функции AWS Lambda.
nameservers список / элементы=строка	Список IPv4-адресов серверов имен, например ‘123.123.123.123’.
ontapi целое число	Используемая версия API ONTAP.
password псевдонимы: pass строка	Пароль указанного пользователя.
skip_validation логический добавлено в netapp.ontap 2.8.0	По умолчанию проверяется доступность всех серверов имен для выполнения разрешения имен. Если DNS-серверы еще не установлены или временно недоступны, для этого параметра можно задать значение ‘true’ и пропустить проверку всех серверов, указанных в поле nameservers. При использовании REST требуется ONTAP 9.9.1 или более поздняя версия; для операций с DNS кластера параметр игнорируется. Варианты: `false` `true`
state строка	Определяет, должны ли DNS-серверы быть включены для указанного vserver. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_lambda логический добавлено в netapp.ontap 23.2.0	Определяет, следует ли использовать функциональность прокси-сервера AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты: `false` ← (по умолчанию) `true`
use_rest строка	Определяет, использовать REST или ZAPI. always — всегда использовать REST API, если модуль поддерживает REST. Если модуль не поддерживает REST, выдается предупреждение. Если параметр модуля не поддерживается в REST, выдается ошибка. never — всегда использовать ZAPI, если модуль поддерживает ZAPI. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка. auto — попытаться использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае использовать ZAPI. По умолчанию: `"always"`
username псевдонимы: user строка	Это может быть учетная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или уровня SVM. Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации: Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью SSL-сертификата клиента и, при необходимости, файла закрытого ключа. Для использования сертификата его необходимо установить в кластере ONTAP и включить аутентификацию по сертификату.
validate_certs логический	Если задано значение `no`, SSL-сертификаты не проверяются. Задавайте значение `False` только для используемых вами сайтов с самозаверяющими сертификатами. Варианты: `false` `true` ← (по умолчанию)
vserver строка	Имя используемого vserver. При использовании REST для DNS кластера в ONTAP 9.13.1 или более поздней версии не указывайте этот параметр либо задайте для него значение NULL; в ONTAP 9.12.1 или более ранней версии укажите в качестве его значения vserver кластера. При использовании ZAPI или REST для DNS кластера в качестве значения также можно указать имя vserver кластера.

Примечания

Примечание

Поддерживается функциональность прокси-сервера AWS Lambda при использовании REST. Пример использования см. в README.
Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
По умолчанию https включен, и его использование рекомендуется. Чтобы включить http в кластере, выполните следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Примеры

- name: Create or modify DNS
  netapp.ontap.na_ontap_dns:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    vserver: "{{ vservername }}"
    domains: sales.bar.com
    nameservers: 10.193.0.250,10.192.0.250
    skip_validation: true

- name: Create or modify cluster DNS with REST
  netapp.ontap.na_ontap_dns:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    domains: sales.bar.com
    nameservers: 10.193.0.250,10.192.0.250

Авторы

Команда NetApp Ansible (@carchi8py)

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

© 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/netapp/ontap/na_ontap_dns_module.html