модуль netapp.ontap.na_ontap_cifs_local_group_member — 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_local_group_member.

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

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

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

Добавление или удаление участника локальной группы CIFS

Требования

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

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

Параметры

Параметр	Комментарии
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.
group string / обязательный	Задает имя локальной группы CIFS
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.
member string / обязательный	Задает имя участника
ontapi integer	Версия API ONTAP, которую следует использовать
password псевдонимы: pass string	Пароль указанного пользователя.
state string	Указывает, должен ли указанный участник входить в локальную группу CIFS Варианты: `"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, выдается ошибка. never — всегда использовать ZAPI, если модуль его поддерживает. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка. auto — пытаться использовать REST API, если модуль его поддерживает и поддерживаются параметры модуля. В противном случае использовать 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, которому принадлежит локальная группа CIFS

Примечания

Примечание

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

Примеры

- name: Add member to CIFS local group
  netapp.ontap.na_ontap_cifs_local_group_member:
    state: present
    vserver: svm1
    group: BUILTIN\administrators
    member: DOMAIN\Domain Admins
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    ontapi: "{{ ontap_facts.ontap_version }}"
    https: true
    validate_certs: false

- name: Remove member from CIFS local group
  netapp.ontap.na_ontap_cifs_local_group_member:
    state: absent
    vserver: svm1
    group: BUILTIN\administrators
    member: DOMAIN\Domain Admins
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    ontapi: "{{ ontap_facts.ontap_version }}"
    https: true
    validate_certs: false

Авторы

Команда 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_local_group_member_module.html