Spec-Zone.ru › Ansible

Модуль 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, где каждый элемент — целое число.

Когда use_rest установлено в auto, это может привести к переключению на ZAPI в зависимости от версии и возможностей платформы.

Игнорируется при использовании ZAPI.

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 клиента.

name

строка / обязательно

Указывает имя локальной группы CIFS

ontapi

целое число

Версия API ontap для использования

password

алиасы: pass

строка

Пароль для указанного пользователя.

state

строка

Указывает, должен ли указанный член входить в состав локальной группы CIFS

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

use_rest

строка

Использовать REST или ZAPI.

always – всегда использует REST API, если модуль его поддерживает. Выводится предупреждение, если модуль не поддерживает REST. Выводится ошибка, если опция модуля не поддерживается в REST.

never – всегда использует ZAPI, если модуль его поддерживает. Может выводиться ошибка, если опция REST не поддерживается в ZAPI.

auto – пытается использовать REST API, если модуль его поддерживает и параметры модулей поддерживаются. В противном случае переходит к ZAPI.

По умолчанию: "auto"

username

алиасы: user

строка

Может быть учётной записью уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или API уровня SVM.

Для получения дополнительной информации ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/.

Поддерживаются два метода аутентификации

  1. базовая аутентификация, используя имя пользователя и пароль,
  2. аутентификация с помощью SSL-сертификата, используя файл SSL-сертификата клиента и, необязательно, файл закрытого ключа.

Для использования сертификата, он должен быть установлен в кластер ONTAP, и должна быть включена аутентификация по сертификатам.

validate_certs

логическое

Если установлено в no, сертификаты SSL не будут проверены.

Это следует установить только в False на сайтах под вашим контролем, использующих самозаверяемые сертификаты.

Варианты:

  • false
  • true ← (по умолчанию)

vserver

строка / обязательно

Указывает vserver, которому принадлежит локальная группа CIFS

Примечания

Примечание

  • Модули с префиксом na_ontap разработаны для поддержки платформы хранения ONTAP.
  • https включен по умолчанию и рекомендуется. Для включения http в кластере необходимо выполнить следующие команды: «set -privilege advanced;» «system services web modify -http-enabled true;»
END_OF_DOCUMENT_MARKER

Примеры

- 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

Авторы

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

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

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API