модуль netapp.ontap.na_ontap_unix_user — пользователи 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_user.

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

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

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

Создание, удаление и изменение локальных пользователей UNIX в ONTAP.

Требования

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

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.
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.
full_name строка	Указывает полное имя пользователя UNIX. Для поддержки REST требуется ONTAP версии 9.9.0 или более поздней. Необязателен при создании, допускает изменение.
hostname строка / обязательный	Имя узла или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределение порта по умолчанию (80 или 443) с помощью этого параметра.
https логический	Включение и отключение HTTPS. Игнорируется при использовании REST, так как поддерживается только HTTPS. Игнорируется при использовании аутентификации с помощью SSL-сертификата, так как для неё требуется SSL. Варианты: `false` ← (по умолчанию) `true`
id целое число	Указывает идентификационный номер пользователя UNIX. Для поддержки REST требуется ONTAP версии 9.9.0 или более поздней. Обязателен при создании, допускает изменение.
key_filepath строка добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
name строка / обязательный	Указывает имя учётной записи UNIX пользователя. Для поддержки REST требуется ONTAP версии 9.9.0 или более поздней. Не допускает изменения.
ontapi целое число	Версия API ONTAP, которую следует использовать.
password псевдонимы: pass строка	Пароль указанного пользователя.
primary_gid псевдонимы: group_id целое число добавлено в netapp.ontap 21.21.0	Указывает идентификационный номер основной группы пользователя UNIX. Для поддержки REST требуется ONTAP версии 9.9.0 или более поздней. Обязателен при создании, допускает изменение.
state строка	Указывает, должен ли указанный пользователь существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_lambda логический добавлено в netapp.ontap 23.2.0	Указывает, следует ли использовать функцию прокси AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты: `false` ← (по умолчанию) `true`
use_rest строка	Определяет, использовать REST или ZAPI. always — всегда использовать REST API, если модуль его поддерживает. Если модуль не поддерживает REST, выводится предупреждение. Если параметр модуля не поддерживается в REST, возникает ошибка. never — всегда использовать ZAPI, если модуль его поддерживает. Если параметр REST не поддерживается в ZAPI, может возникнуть ошибка. auto — попытаться использовать REST API, если модуль его поддерживает и поддерживаются параметры модуля. В противном случае используется ZAPI. По умолчанию: `"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 для пользователя UNIX. Для поддержки REST требуется ONTAP версии 9.9.0 или более поздней. Не допускает изменения.

Примечания

Примечание

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

Примеры

- name: Create UNIX User
  netapp.ontap.na_ontap_unix_user:
    state: present
    name: SampleUser
    vserver: ansibleVServer
    group_id: 1
    id: 2
    full_name: Test User
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete UNIX User
  netapp.ontap.na_ontap_unix_user:
    state: absent
    name: SampleUser
    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_user_module.html