netapp.ontap.na_ontap_qtree – NetApp ONTAP управление qtrees
Примечание
Этот плагин является частью коллекции netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в плейбуке укажите: netapp.ontap.na_ontap_qtree.
Новое в версии 2.6.0: of netapp.ontap
Обзор
- Создание или удаление Qtrees.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- Физическая или виртуальная кластерная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии.
- Поддержка REST требует ONTAP 9.6 или более поздней версии.
- Ansible 2.6
- Сильно рекомендуется использовать Ansible 2.9 или более поздние версии, так как это позволит использовать новую систему доставки коллекций.
- Python2 netapp-lib (2017.10.30) или более поздняя версия. Установите с помощью ‘pip install netapp-lib’
- Python3 netapp-lib (2018.11.13) или более поздняя версия. Установите с помощью ‘pip install netapp-lib’
- netapp-lib 2020.3.12 рекомендуется для лучшего отображения сообщений об ошибках при подключении.
- Для включения http в кластере необходимо выполнить следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cert_filepath строка добавлен в 20.6.0 netapp.ontap | путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6. | |
| export_policy строка добавлен в 2.9.0 netapp.ontap | Имя политики экспорта, которая должна применяться. | |
| feature_flags словарь добавлен в 20.5.0 netapp.ontap | Включение или отключение новой функции. Это может быть использовано для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| flexvol_name строка / обязательно | Имя FlexVol, на котором должен существовать qtree. | |
| force_delete логическое значение добавлен в 20.8.0 netapp.ontap |
| Необходимо ли удалить qtree, даже если файлы все еще существуют. Обратите внимание, что значение по умолчанию true отражает поведение REST API. значение false не поддерживается REST. |
| from_name строка добавлен в 2.7.0 netapp.ontap | Имя qtree, которое должно быть переименовано. | |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Переопределить порт по умолчанию (80 или 443) на этот порт | |
| https логическое значение |
| Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как требуется SSL. |
| key_filepath строка добавлен в 20.6.0 netapp.ontap | путь к файлу ключа SSL-клиента. | |
| name строка / обязательно | Имя qtree, которое нужно управлять. | |
| ontapi целое число | Версия API ontap, которую нужно использовать | |
| oplocks строка добавлен в 2.9.0 netapp.ontap |
| Включить или отключить oplocks для qtree. |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| security_style строка добавлен в 2.9.0 netapp.ontap |
| Стиль безопасности для qtree. |
| state строка |
| Существует ли указанная qtree или нет. |
| time_out целое число добавлен в 2.9.0 netapp.ontap | По умолчанию: 180 | Максимальное время ожидания удаления qtree в секундах, когда wait_for_completion равно True. Ошибка, если задача не завершена в заданное время. Значение по умолчанию установлено на 3 минуты. |
| unix_permissions строка добавлен в 2.9.0 netapp.ontap | Разрешения файлов qtree. | |
| use_rest строка | По умолчанию: "авто" | REST API, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае вернётся к ZAPI. всегда — всегда использовать REST API никогда — всегда использовать ZAPI авто — попытаться использовать REST API |
| username строка | Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Для получения дополнительной информации, пожалуйста, прочитайте документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. базовая аутентификация, используя имя пользователя и пароль, 2. аутентификация по SSL-сертификату, используя файл SSL-сертификата клиента и, необязательно, файл приватного ключа. Для использования сертификата, сертификат должен быть установлен в кластере ONTAP, и аутентификация по сертификату должна быть включена. псевдонимы: user |
| validate_certs boolean |
| Если установлено в no, сертификаты SSL не будут проверены.Это следует устанавливать только в False для сайтов, контролируемых лично, использующих самозаверенные сертификаты. |
| vserver строка / обязательно | Имя vserver для использования. | |
| wait_for_completion boolean добавлено в 2.9.0 netapp.ontap |
| Применимо только для REST. При использовании ZAPI удаление всегда синхронное. Удаление qtree может занять время, если нужно удалить много файлов. Установите этот параметр в 'true' для синхронного выполнения во время удаления. Установите этот параметр в 'false' для асинхронного выполнения. При асинхронном выполнении процесс завершается сразу после отправки запроса, а удаление qtree происходит в фоновом режиме. |
Примечания
Примечание
- Модули с префиксом na\_ontap разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: Create Qtrees
na_ontap_qtree:
state: present
name: ansibleQTree
flexvol_name: ansibleVolume
export_policy: policyName
security_style: mixed
oplocks: disabled
unix_permissions:
vserver: ansibleVServer
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Rename Qtrees
na_ontap_qtree:
state: present
from_name: ansibleQTree_rename
name: ansibleQTree
flexvol_name: ansibleVolume
vserver: ansibleVServer
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
Авторы
- Команда NetApp Ansible (@carchi8py) <ng-ansibleteam@netapp.com>
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/netapp/ontap/na_ontap_qtree_module.html