модуль netapp.ontap.na_ontap_ntfs_dacl – создание, удаление или изменение NTFS DACL (дискреционного списка управления доступом) в NetApp Ontap
Примечание
Этот модуль входит в коллекцию netapp.ontap (версия 23.5.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install netapp.ontap. Для работы с этим модулем требуются дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать его в плейбуке, укажите: netapp.ontap.na_ontap_ntfs_dacl.
Добавлено в netapp.ontap 20.4.0
Краткое описание
- Создание, изменение или удаление NTFS DACL
Требования
На узле, на котором выполняется этот модуль, необходимы следующие компоненты.
- Ansible 2.9 или новее — рекомендуется версия 2.12 или новее.
- Python 3 — рекомендуется версия 3.9 или новее.
- netapp-lib требуется только при использовании ZAPI (установите с помощью команды ‘pip install netapp-lib’). Обратите внимание, что netapp-lib объявлена устаревшей и больше не поддерживается. Используйте её на свой страх и риск.
- Физическая или виртуальная кластерная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии; для поддержки REST требуется ONTAP 9.6 или новее.
Параметры
Параметр | Комментарии |
|---|---|
access_type string / обязательный | Указывает тип доступа ACE в DACL. Возможные значения. Варианты:
|
account string / обязательный | Указывает SID или имя доменной учётной записи ACE в DACL дескриптора безопасности NTFS. |
advanced_access_rights list / элементы=string | Указывает расширенные права доступа ACE в DACL. Несовместим с параметром rights. Варианты:
|
apply_to list / элементы=string | Указывает, к чему применяется запись DACL. Варианты:
|
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, причём каждый компонент должен быть целым числом. Если для Игнорируется при использовании ZAPI. |
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. |
ontapi integer | Версия API ONTAP, которую следует использовать. |
password псевдонимы: pass string | Пароль указанного пользователя. |
rights string | Указывает права доступа ACE в DACL. Несовместим с параметром advanced_access_rights. Варианты:
|
security_descriptor string / обязательный | Указывает дескриптор безопасности NTFS. |
state string | Определяет, должна ли указанная NTFS DACL существовать. Варианты:
|
use_lambda boolean добавлено в netapp.ontap 23.2.0 | Указывает, следует ли использовать прокси-функциональность AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты:
|
use_rest string | Определяет, использовать REST или ZAPI. always — всегда использовать REST API, если модуль поддерживает REST. Если модуль не поддерживает REST, выводится предупреждение. Если параметр модуля не поддерживается в REST, возникает ошибка. never — всегда использовать ZAPI, если модуль поддерживает ZAPI. Может возникнуть ошибка, если параметр REST не поддерживается в ZAPI. auto — пытаться использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае использовать ZAPI. По умолчанию: |
username псевдонимы: user string | Это может быть учётная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или уровня SVM. Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации:
Чтобы использовать сертификат, его необходимо установить в кластере ONTAP и включить аутентификацию по сертификату. |
validate_certs boolean | Если задано значение Значение Варианты:
|
vserver string / обязательный | Указывает vserver для NTFS DACL. |
Примечания
Примечание
- Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
- HTTPS включён по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, выполните следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’
Примеры
- name: Add NTFS DACL
netapp.ontap.na_ontap_ntfs_dacl:
state: present
vserver: SVM1
security_descriptor: ansible_sd
access_type: allow
account: DOMAIN\Account
rights: modify
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Modify NTFS DACL
netapp.ontap.na_ontap_ntfs_dacl:
state: present
vserver: SVM1
security_descriptor: ansible_sd
access_type: full_control
account: DOMAIN\Account
rights: modify
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Remove NTFS DACL
netapp.ontap.na_ontap_ntfs_dacl:
state: absent
vserver: SVM1
security_descriptor: ansible_sd
account: DOMAIN\Account
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_ntfs_dacl_module.html