netapp.ontap.na_ontap_cifs – NetApp ONTAP Manage cifs-share
Примечание
Этот плагин входит в коллекцию netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в плейбуке, укажите: netapp.ontap.na_ontap_cifs.
Новое в версии 2.6.0: of netapp.ontap
Обзор
- Создать, удалить или изменить (путь) cifs-share на ONTAP
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- Физическая или виртуальная кластеризованная система 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. | |
| feature_flags словарь добавлен в 20.5.0 netapp.ontap | Включение или выключение новой функции. Это можно использовать для активации экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Переопределить порт по умолчанию (80 или 443) на указанный порт | |
| https булево |
| Включить и выключить https. Игнорируется при использовании REST, так как только https поддерживается. Игнорируется при использовании аутентификации с сертификатом SSL, так как она требует SSL. |
| key_filepath строка добавлен в 20.6.0 netapp.ontap | путь к файлу ключа SSL клиента. | |
| ontapi целое число | Версия API ontap для использования | |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| path строка | Путь к файловой системе, который совместно используется через эту CIFS-папку. Путь — это полный, видимый для пользователя путь, относительный к корню vserver, и он может пересекать точки монтирования соединения. Путь в формате UTF8 и использует прямую косую черту в качестве разделителя каталогов. | |
| share_name строка / обязательно | Имя CIFS-папки. Имя CIFS-папки — это строка UTF-8, в которой недопустимы следующие символы: управляющие символы с 0x00 по 0x1F включительно, 0x22 (двойные кавычки). | |
| share_properties список / элементы=строка добавлен в 2.8.0 netapp.ontap | Список свойств для CIFS-папки | |
| state строка |
| Требуется ли существование указанной CIFS-папки. |
| symlink_properties список / элементы=строка добавлен в 2.8.0 netapp.ontap | Список свойств символической ссылки для данной CIFS-папки | |
| 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 булево |
| Если установлено в no, сертификаты SSL не будут проверены.Это следует устанавливать только в False при использовании на контролируемых лично сайтах с самозаверяющимися сертификатами. |
| vscan_fileop_profile строка добавлен в 2.9.0 netapp.ontap |
| Набор профилей file_ops, к которым применимо сканирование vscan при доступе. |
| vserver строка / обязательно | Vserver, содержащий CIFS-папку. |
Примечания
Примечание
- Модули с префиксом na\_ontap разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: Create CIFS share
na_ontap_cifs:
state: present
share_name: cifsShareName
path: /
vserver: vserverName
share_properties: browsable,oplocks
symlink_properties: read_only,enable
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Delete CIFS share
na_ontap_cifs:
state: absent
share_name: cifsShareName
vserver: vserverName
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Modify path CIFS share
na_ontap_cifs:
state: present
share_name: pb_test
vserver: vserverName
path: /
share_properties: show_previous_versions
symlink_properties: disable
vscan_fileop_profile: no_scan
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_cifs_module.html
