netapp.ontap.na_ontap_cifs_acl – NetApp ONTAP управление контролем доступа к cifs-объемам
Примечание
Этот плагин входит в коллекцию netapp.ontap (версия 20.12.0).
Для установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в книге задач укажите: netapp.ontap.na_ontap_cifs_acl.
Новое в версии 2.6.0: плагина netapp.ontap
Обзор
- Создание, удаление или изменение контролей доступа к ресурсам cifs-объемов 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 | |
| permission строка |
| -"Права доступа, которые пользователь или группа имеют к определенному CIFS-объему." |
| share_name строка / обязательно | Имя cifs-share-access-control для управления. | |
| state строка |
| Необходимо ли существование указанного CIFS-объема. |
| use_rest строка | Значение по умолчанию: "авто" | REST API, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае возвращается к ZAPI. всегда — всегда использует REST API никогда — всегда использует ZAPI авто — попытается использовать REST API |
| user_or_group строка / обязательно | Имя пользователя или группы, для которых отображаются разрешения. | |
| username строка | Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Дополнительную информацию можно найти в документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. аутентификация по протоколу basic, с использованием имени пользователя и пароля, 2. аутентификация по SSL-сертификату, с использованием файла ssl-сертификата клиента и, необязательно, файла приватного ключа. Для использования сертификата, он должен быть установлен в кластере ONTAP, а аутентификация по сертификатам должна быть включена. псевдонимы: user | |
| validate_certs булево |
| Если установлено no, SSL-сертификаты не будут проверяться.Это следует установить только в False на сайтах с собственными сертификатами. |
| vserver строка / обязательно | Имя vserver для использования. |
Примечания
Примечание
- Модули с префиксом na\_ontap разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: Create CIFS share acl
na_ontap_cifs_acl:
state: present
share_name: cifsShareName
user_or_group: Everyone
permission: read
vserver: "{{ netapp_vserver }}"
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Modify CIFS share acl permission
na_ontap_cifs_acl:
state: present
share_name: cifsShareName
user_or_group: Everyone
permission: change
vserver: "{{ netapp_vserver }}"
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_acl_module.html
