Модуль netapp.ontap.na_ontap_ntfs_sd — создание, удаление или изменение дескриптора безопасности NTFS в 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_sd.

Добавлено в netapp.ontap 20.4.0

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

Создание, изменение или удаление дескриптора безопасности NTFS

Требования

На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.

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 или более поздняя версия.

Параметры

Параметр	Комментарии
cert_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
control_flags_raw integer	Задает управляющие флаги дескриптора безопасности. 1… …. …. …. = Относительный к себе .0.. …. …. …. = Управление RM действительно ..0. …. …. …. = SACL защищен …0 …. …. …. = DACL защищен …. 0… …. …. = SACL унаследован …. .0.. …. …. = DACL унаследован …. ..0. …. …. = Требуется наследование SACL …. …0 …. …. = Требуется наследование DACL …. …. ..0. …. = SACL задан по умолчанию …. …. …0 …. = SACL присутствует …. …. …. 0… = DACL задан по умолчанию …. …. …. .1.. = DACL присутствует …. …. …. ..0. = Группа задана по умолчанию …. …. …. …0 = Владелец задан по умолчанию В настоящее время учитываются только следующие флаги. Остальные игнорируются. ..0. …. …. …. = SACL защищен …0 …. …. …. = DACL защищен …. …. ..0. …. = SACL задан по умолчанию …. …. …. 0… = DACL задан по умолчанию …. …. …. ..0. = Группа задана по умолчанию …. …. …. …0 = Владелец задан по умолчанию Преобразуйте 16-битные двоичные флаги в десятичное число и укажите его в качестве входного значения.
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, причем каждый элемент должен быть целым числом. Если для `use_rest` задано значение auto, этот параметр может принудительно переключить модуль на ZAPI в зависимости от версии и возможностей платформы. Игнорируется при использовании ZAPI.
group string	Задает SID группы или доменную учетную запись дескриптора безопасности NTFS. Необходимо указать полный путь к группе.
hostname string / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределяет порт по умолчанию (80 или 443).
https boolean	Включает и отключает HTTPS. Игнорируется при использовании REST, поскольку поддерживается только HTTPS. Игнорируется при аутентификации с помощью SSL-сертификата, так как для нее требуется SSL. Варианты: `false` ← (по умолчанию) `true`
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
name string / обязательный	Задает имя дескриптора безопасности NTFS. Изменению не подлежит.
ontapi integer	Версия API ONTAP, которую следует использовать.
owner string	Задает SID владельца или доменную учетную запись дескриптора безопасности NTFS. Необходимо указать полный путь к владельцу.
password псевдонимы: pass string	Пароль указанного пользователя.
state string	Указывает, должен ли существовать указанный дескриптор безопасности NTFS. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_lambda boolean добавлено в netapp.ontap 23.2.0	Указывает, следует ли использовать прокси-функцию AWS Lambda для подключения к системе ONTAP. Поддерживается только с REST. Варианты: `false` ← (по умолчанию) `true`
use_rest string	Определяет, использовать REST или ZAPI. always — всегда использовать REST API, если модуль поддерживает REST. Если модуль не поддерживает REST, выдается предупреждение. Если параметр модуля не поддерживается в REST, выдается ошибка. never — всегда использовать ZAPI, если модуль поддерживает ZAPI. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка. auto — пытаться использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае выполняется переход на ZAPI. По умолчанию: `"always"`
username псевдонимы: user string	Это может быть учетная запись уровня кластера или уровня SVM — в зависимости от того, какой API требуется: уровня кластера или уровня SVM. Дополнительную информацию см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации. Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью SSL-сертификата — файла сертификата клиента SSL и, при необходимости, файла закрытого ключа. Для использования сертификата его необходимо установить в кластере ONTAP и включить аутентификацию по сертификату.
validate_certs boolean	Если задано значение `no`, сертификаты SSL не проверяются. Устанавливайте это значение только в `False` на сайтах под личным контролем, использующих самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vserver string / обязательный	Задает vserver для дескриптора безопасности NTFS.

Примечания

Примечание

Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
HTTPS включен по умолчанию, и его рекомендуется использовать. Чтобы включить HTTP в кластере, необходимо выполнить следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Примеры

- name: Create NTFS Security Descriptor
  netapp.ontap.na_ontap_ntfs_sd:
    state: present
    vserver: SVM1
    name: ansible_sd
    owner: DOMAIN\Account
    group: DOMAIN\Group
    control_flags_raw: 0
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Modify NTFS Security Descriptor
  netapp.ontap.na_ontap_ntfs_sd:
    state: present
    vserver: SVM1
    name: ansible_sd
    owner: DOMAIN\Account
    group: DOMAIN\Group
    control_flags_raw: 0
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete NTFS Security Descriptor
  netapp.ontap.na_ontap_ntfs_sd:
    state: absent
    vserver: SVM1
    name: ansible_sd
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

Команда NetApp Ansible (@carchi8py)

Ссылки на коллекцию

© 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_sd_module.html