модуль netapp.ontap.na_ontap_local_hosts — локальные хосты NetApp ONTAP
Примечание
Этот модуль входит в коллекцию netapp.ontap (версия 23.5.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля требуются дополнительные компоненты. Подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: netapp.ontap.na_ontap_local_hosts.
Добавлено в netapp.ontap 22.0.0
Краткое описание
- Создание, удаление и изменение локальных хостов в ONTAP.
Требования
Следующие требования должны быть выполнены на хосте, где запускается этот модуль.
- 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 или более поздняя версия.
Параметры
Параметр | Комментарии |
|---|---|
address string / обязательный | Адрес IPv4/IPv6 в точечной записи. |
aliases list / elements=string | Список псевдонимов. |
cert_filepath string добавлено в netapp.ontap 20.6.0 | Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6. |
feature_flags dictionary добавлено в netapp.ontap 20.5.0 | Включение или отключение новой функции. Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут изменяться без уведомления. Неизвестные ключи игнорируются. |
force_ontap_version string добавлено в netapp.ontap 21.23.0 | Переопределяет версию ONTAP кластера при использовании REST. Если версия не соответствует целевому кластеру, поведение не определено. Этот параметр предусмотрен как обходное решение в случаях, когда невозможно прочитать версию кластера из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Значение должно иметь формат 9.10 или 9.10.1, где каждый элемент — целое число. |
host string | Каноническое имя хоста. Минимальная длина — 1 символ, максимальная — 255 символов. |
hostname string / обязательный | Имя хоста или IP-адрес экземпляра ONTAP. |
http_port integer | Позволяет заменить порт по умолчанию (80 или 443) указанным портом. |
https boolean | Включение и отключение HTTPS. Игнорируется при использовании REST, так как поддерживается только HTTPS. Игнорируется при использовании аутентификации по сертификату SSL, поскольку для неё требуется SSL. Варианты:
|
key_filepath string добавлено в netapp.ontap 20.6.0 | Путь к файлу ключа клиента SSL. |
lambda_config dictionary добавлено в netapp.ontap 23.5.0 | Параметры конфигурации функции прокси-сервера AWS Lambda. Этот параметр и его подчинённые параметры поддерживаются только при использовании REST. |
|
aws_profile string |
Имя профиля AWS, используемого для аутентификации. |
|
aws_region string / обязательный |
Имя региона AWS. |
|
function_name string / обязательный |
Имя вызываемой функции AWS Lambda. |
owner string / обязательный | Имя SVM с данными или кластера. |
password псевдоним: pass string | Пароль указанного пользователя. |
state string | Должны ли указанные локальные хосты существовать. Варианты:
|
use_lambda boolean добавлено в netapp.ontap 23.4.0 | Указывает, следует ли использовать функцию прокси-сервера AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты:
|
use_rest string | Этот модуль поддерживает только REST. always — всегда использовать REST API. Если модуль не поддерживает REST, будет выдано предупреждение. По умолчанию: |
username псевдоним: user string | Это может быть учётная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или уровня SVM. Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации
Чтобы использовать сертификат, его необходимо установить в кластере ONTAP, а аутентификацию по сертификату — включить. |
validate_certs boolean | Если задано значение Задавайте это значение только для Варианты:
|
Примечания
Примечание
- Поддерживается функция прокси-сервера AWS Lambda. Примеры см. в файле README.
- Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
- HTTPS включён по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, выполните следующие команды: «set -privilege advanced;» «system services web modify -http-enabled true;»
Примеры
- name: Create IP to host mapping
netapp.ontap.na_ontap_local_hosts:
state: present
address: 10.10.10.10
host: example.com
aliases: ['ex1.com', 'ex2.com']
owner: svm1
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Modify IP to host mapping
netapp.ontap.na_ontap_local_hosts:
state: present
address: 10.10.10.10
owner: svm1
host: example1.com
aliases: ['ex1.com', 'ex2.com', 'ex3.com']
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Delete host object
netapp.ontap.na_ontap_local_hosts:
state: absent
address: 10.10.10.10
owner: svm1
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
Ссылки на коллекцию
© 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_local_hosts_module.html