Модуль netapp.ontap.na_ontap_dns — Создание, удаление, изменение DNS-серверов NetApp ONTAP.
Примечание
Этот модуль входит в коллекцию netapp.ontap (версия 22.12.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-API модуль в настоящее время ограничен виртуальными серверами данных для операций удаления или изменения.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- Ansible 2.9 или более поздней версии — рекомендуется 2.12 или более поздняя.
- Python3 — 3.9 или более поздней версии — рекомендуется.
- При использовании ZAPI, netapp-lib 2018.11.13 или более поздней версии (установить с помощью ‘pip install netapp-lib’), настоятельно рекомендуется netapp-lib 2020.3.12, так как она обеспечивает лучшую обработку ошибок при подключении.
- Физическая или виртуальная кластерная система 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, где каждый элемент — целое число. Когда Игнорируется с ZAPI. |
hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. |
http_port целое число | Переопределить порт по умолчанию (80 или 443) на этот порт |
https булево | Включение и отключение https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как она требует SSL. Варианты:
|
key_filepath строка добавлен в netapp.ontap 20.6.0 | путь к файлу закрытого ключа SSL-клиента. |
nameservers список / элементы=строка | Список IPv4-адресов именных серверов, таких как ‘123.123.123.123’. |
ontapi целое число | Используемая версия ONTAP API |
password псевдонимы: pass строка | Пароль для указанного пользователя. |
skip_validation булево добавлен в netapp.ontap 2.8.0 | По умолчанию все именные серверы проверяются на доступность для разрешения. Если ваши DNS-серверы еще не установлены или временно недоступны, вы можете установить этот параметр в ‘true’, чтобы пропустить проверку всех серверов, указанных в поле nameservers. Для REST требуется ONTAP 9.9.1 или более поздняя версия и игнорируется для операций с кластерным DNS. Варианты:
|
state строка | Включить или отключить DNS-серверы для данного vserver. Варианты:
|
use_rest строка | Использовать REST или ZAPI. always — всегда использовать REST API, если модуль его поддерживает. Выводится предупреждение, если REST не поддерживается. Выводится ошибка, если параметр модуля не поддерживается в REST. never — всегда использовать ZAPI, если модуль его поддерживает. Возможна ошибка, если параметр REST не поддерживается в ZAPI. auto — попробовать использовать REST API, если модуль его поддерживает и параметры модуля поддерживаются. В противном случае вернется к ZAPI. По умолчанию: |
username псевдонимы: user строка | Это может быть учётная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Для получения дополнительной информации, пожалуйста, прочитайте документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации
Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена. |
validate_certs булево | Если установлено Это должно быть установлено в Варианты:
|
vserver строка | Имя vserver для использования. Для кластерного DNS в REST этот параметр следует опустить или установить в NULL. Для кластерного DNS в ZAPI или REST можно также установить имя кластерного vserver. |
Примечания
Примечание
- Модули с префиксом 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
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
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
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
domains: sales.bar.com
nameservers: 10.193.0.250,10.192.0.250
Ссылки на сборку
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/netapp/ontap/na_ontap_dns_module.html
