Модуль netapp.ontap.na_ontap_cifs_acl – NetApp ONTAP: управление контролем доступа к общим ресурсам CIFS

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 23.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: netapp.ontap.na_ontap_cifs_acl.

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

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

Создание, удаление или изменение правил управления доступом к общим ресурсам CIFS в ONTAP

Требования

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

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.
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.
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-клиента.
lambda_config dictionary добавлено в netapp.ontap 23.4.0	Параметры конфигурации функции прокси AWS Lambda. Этот параметр и его вложенные параметры поддерживаются только при использовании REST.
aws_profile string	Имя профиля AWS для аутентификации.
aws_region string / обязательный	Название региона AWS.
function_name string / обязательный	Имя вызываемой функции AWS Lambda.
ontapi integer	Версия API ONTAP, которую следует использовать
password псевдонимы: pass string	Пароль указанного пользователя.
permission string	Права доступа пользователя или группы к указанному общему ресурсу CIFS. Варианты: `"no_access"` `"read"` `"change"` `"full_control"`
share_name псевдонимы: share string / обязательный	Имя общего ресурса CIFS, правила управления доступом к которому требуется настроить.
state string	Должен ли указанный список ACL общего ресурса CIFS существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
type string добавлено в netapp.ontap 21.17.0	Тип (также называемый типом пользователя или группы) пользователя или группы, добавляемых в ACL. В ZAPI тип обязателен при создании, удалении и изменении записей unix-user или unix-group в ACL. Варианты: `"windows"` `"unix_user"` `"unix_group"`
use_lambda boolean добавлено в netapp.ontap 23.2.0	Определяет, следует ли использовать функцию прокси AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты: `false` ← (по умолчанию) `true`
use_rest string	Использовать REST или ZAPI. always — всегда использовать REST API, если модуль его поддерживает. Если модуль не поддерживает REST, выводится предупреждение. Если параметр модуля не поддерживается в REST, выводится ошибка. never — всегда использовать ZAPI, если модуль его поддерживает. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка. auto — пытаться использовать REST API, если модуль его поддерживает и параметры модуля поддерживаются. В противном случае использовать ZAPI. По умолчанию: `"always"`
user_or_group string / обязательный	Имя пользователя или группы, для которых указаны разрешения.
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.

Примечания

Примечание

Поддерживается функция прокси AWS Lambda при использовании REST. Примеры см. в файле README.
Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
HTTPS включён по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, выполните следующие команды: «set -privilege advanced;» «system services web modify -http-enabled true;»

Примеры

- name: Create CIFS share ACL
  netapp.ontap.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
  netapp.ontap.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 }}"

- name: Delete CIFS share ACL
  netapp.ontap.na_ontap_cifs_acl:
    state: absent
    share_name: cifsShareName
    user_or_group: localUser
    permission: read
    vserver: "{{ netapp_vserver }}"
    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_cifs_acl_module.html