Модуль netapp.ontap.na_ontap_unix_group — группа UNIX в NetApp ONTAP

Примечание

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

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

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

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

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

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

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

Создание/удаление группы пользователей Unix

Требования

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

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`
id integer	Задает идентификационный номер группы UNIX. ID группы уникален для каждой группы UNIX. Обязателен при создании, допускает изменение.
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
name string / обязательный	Задает имя группы UNIX, уникальное для каждой группы. Не допускает изменения.
ontapi integer	Версия API ONTAP, которую следует использовать.
password псевдонимы: pass string	Пароль указанного пользователя.
skip_name_validation boolean	Указывает, следует ли пропустить проверку имени группы. Варианты: `false` `true`
state string	Определяет, должна ли указанная группа существовать. Варианты: `"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, если модуль поддерживает 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 и включить аутентификацию по сертификату.
users list / элементы=string добавлено в netapp.ontap 2.9.0	Задает пользователей, входящих в эту группу. Список должен быть разделен запятыми. Задает ожидаемое состояние списка пользователей на текущий момент. Добавляет пользователя в группу, если он указан в ожидаемом состоянии, но отсутствует в текущем. Удаляет пользователя из группы, если он указан в текущем состоянии, но отсутствует в ожидаемом. Чтобы удалить всех текущих пользователей, укажите в качестве значения ‘’.
validate_certs boolean	Если задано значение `no`, SSL-сертификаты не будут проверяться. Это следует задавать только при использовании самоподписанных сертификатов на сайтах, контролируемых лично вами; задайте значение `False`. Варианты: `false` `true` ← (по умолчанию)
vserver string / обязательный	Задает Vserver для группы UNIX. Не допускает изменения.

Примечания

Примечание

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

Примеры

- name: Create UNIX group
  netapp.ontap.na_ontap_unix_group:
    state: present
    name: SampleGroup
    vserver: ansibleVServer
    id: 2
    users: user1,user2
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete all users in UNIX group
  netapp.ontap.na_ontap_unix_group:
    state: present
    name: SampleGroup
    vserver: ansibleVServer
    users: ''
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete UNIX group
  netapp.ontap.na_ontap_unix_group:
    state: absent
    name: SampleGroup
    vserver: ansibleVServer
    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_unix_group_module.html