Модуль netapp.ontap.na_ontap_cifs_local_group — 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.

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

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

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

Создание, удаление или изменение локальной группы CIFS.

Требования

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

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 строка добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
description строка	Описание локальной группы.
feature_flags словарь добавлено в netapp.ontap 20.5.0	Включение или отключение новой функции. Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут изменяться без предварительного уведомления. Неизвестные ключи игнорируются.
force_ontap_version строка добавлено в netapp.ontap 21.23.0	Переопределение версии ONTAP кластера при использовании REST. Если указанная версия не соответствует версии целевого кластера, поведение не определено. Этот параметр предоставляется в качестве обходного решения, если из-за проблем с разрешениями не удаётся прочитать версию кластера. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Версию следует указывать в формате 9.10 или 9.10.1; каждый элемент должен быть целым числом.
from_name строка	Указывает имя существующей локальной группы CIFS. Этот параметр используется для переименования локальной группы CIFS.
hostname строка / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределение порта по умолчанию (80 или 443) указанным портом.
https логический	Включение или отключение HTTPS. Игнорируется при использовании REST, так как поддерживается только HTTPS. Игнорируется при аутентификации с помощью сертификата SSL, поскольку для неё требуется SSL. Варианты: `false` ← (по умолчанию) `true`
key_filepath строка добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
lambda_config словарь добавлено в netapp.ontap 23.4.0	Параметры конфигурации функции прокси-сервера AWS Lambda. Этот параметр и его подопции поддерживаются только при использовании REST.
aws_profile строка	Имя профиля AWS, используемого для аутентификации.
aws_region строка / обязательный	Название региона AWS.
function_name строка / обязательный	Имя вызываемой функции AWS Lambda.
name строка / обязательный	Указывает имя локальной группы CIFS.
password псевдонимы: pass строка	Пароль указанного пользователя.
state строка	Определяет, должен ли указанный участник входить в локальную группу CIFS. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_lambda логический добавлено в netapp.ontap 23.4.0	Указывает, следует ли использовать функцию прокси-сервера AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты: `false` ← (по умолчанию) `true`
use_rest строка	Этот модуль поддерживает только REST. always — всегда использовать REST API. Если модуль не поддерживает REST, будет выдано предупреждение. По умолчанию: `"always"`
username псевдонимы: user строка	Это может быть учётная запись уровня кластера или уровня SVM — в зависимости от того, какой API требуется: уровня кластера или уровня SVM. Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации: Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью сертификата SSL — с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа. Чтобы использовать сертификат, его необходимо установить в кластере ONTAP, а аутентификацию по сертификату — включить.
validate_certs логический	Если задано значение `no`, сертификаты SSL не будут проверяться. Задавать значение `False` следует только на контролируемых вами площадках, использующих самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vserver строка / обязательный	Указывает vserver, которому принадлежит локальная группа CIFS.

Примечания

Примечание

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

Примеры

- name: Create CIFS local group
  netapp.ontap.na_ontap_cifs_local_group:
    state: present
    vserver: svm1
    name: BUILTIN\administrators
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    https: true
    validate_certs: false

- name: Delete CIFS local group
  netapp.ontap.na_ontap_cifs_local_group:
    state: absent
    vserver: svm1
    name: BUILTIN\administrators
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    https: true
    validate_certs: false

- name: Modify CIFS local group description
  netapp.ontap.na_ontap_cifs_local_group:
    state: present
    vserver: svm1
    name: BUILTIN\administrators
    descrition: 'CIFS local group'
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    https: true
    validate_certs: false

- name: Rename CIFS local group description
  netapp.ontap.na_ontap_cifs_local_group:
    state: present
    vserver: svm1
    name: ANSIBLE_CIFS\test_users
    descrition: 'CIFS local group'
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    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_module.html