Модуль netapp.ontap.na_ontap_cifs_local_group – NetApp Ontap - создание, удаление или изменение локальной группы CIFS.
Примечание
Этот модуль входит в коллекцию netapp.ontap (версия 22.12.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 или более поздняя версия рекомендуется.
- При использовании ZAPI, netapp-lib 2018.11.13 или более поздняя версия (установить с помощью ‘pip install netapp-lib’), настоятельно рекомендуется netapp-lib 2020.3.12, так как она предоставляет более подробные сообщения об ошибках при подключении.
- Физическая или виртуальная кластеризованная система 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, где каждый элемент — целое число. Когда Игнорируется при использовании ZAPI. |
from_name строка | Указывает имя существующей локальной группы cifs. Этот параметр используется для переименования локальной группы cifs. |
hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. |
http_port целое число | Переопределить порт по умолчанию (80 или 443) на этот порт |
https логическое | Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при аутентификации с помощью сертификата SSL, так как это требует SSL. Варианты:
|
key_filepath строка добавлено в netapp.ontap 20.6.0 | путь к файлу закрытого ключа SSL клиента. |
name строка / обязательно | Указывает имя локальной группы CIFS |
ontapi целое число | Версия API ontap для использования |
password алиасы: pass строка | Пароль для указанного пользователя. |
state строка | Указывает, должен ли указанный член входить в состав локальной группы CIFS Варианты:
|
use_rest строка | Использовать REST или ZAPI. always – всегда использует REST API, если модуль его поддерживает. Выводится предупреждение, если модуль не поддерживает REST. Выводится ошибка, если опция модуля не поддерживается в REST. never – всегда использует ZAPI, если модуль его поддерживает. Может выводиться ошибка, если опция REST не поддерживается в ZAPI. auto – пытается использовать REST API, если модуль его поддерживает и параметры модулей поддерживаются. В противном случае переходит к ZAPI. По умолчанию: |
username алиасы: user строка | Может быть учётной записью уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или API уровня SVM. Для получения дополнительной информации ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации
Для использования сертификата, он должен быть установлен в кластер ONTAP, и должна быть включена аутентификация по сертификатам. |
validate_certs логическое | Если установлено в Это следует установить только в Варианты:
|
vserver строка / обязательно | Указывает vserver, которому принадлежит локальная группа CIFS |
Примечания
Примечание
- Модули с префиксом 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
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
https: true
validate_certs: false
- name: Delete CIFS local group
netapp.ontap.na_ontap_cifs_local_group:
state: absent
vserver: svm1
name: BUILTIN\administrators
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
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'
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
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'
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
https: true
validate_certs: false
Ссылки на коллекции
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/netapp/ontap/na_ontap_cifs_local_group_module.html