Модуль netapp.ontap.na_ontap_active_directory – настройка Active Directory в NetApp ONTAP

Примечание

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

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

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

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

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

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

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

Настройка Active Directory.
Для работы REST требуется ONTAP 9.12.1 или более поздняя версия.

Требования

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

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 или более поздняя версия.

Параметры

Параметр	Описание
account_name string / обязательный	Имя учётной записи Active Directory в формате NetBIOS. Изменение имени существующей учётной записи не поддерживается. Учётную запись необходимо удалить и создать заново.
admin_password string / обязательный	Пароль администратора, необходимый для создания учётной записи Active Directory.
admin_username string / обязательный	Имя пользователя-администратора, необходимое для создания учётной записи Active Directory.
cert_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата SSL-клиента (.pem). Не поддерживается в Python 2.6.
domain псевдонимы: fqdn string	Полное доменное имя.
feature_flags dictionary добавлено в netapp.ontap 20.5.0	Включение или отключение новой функции. Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут измениться без предварительного уведомления. Неизвестные ключи игнорируются.
force_account_overwrite boolean	Если значение равно true и в Active Directory существует учётная запись компьютера с именем, указанным в параметре «account-name», она будет перезаписана и использована повторно. Варианты: `false` `true`
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`
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа SSL-клиента.
ontapi integer	Версия API ONTAP, которую следует использовать.
organizational_unit string	Подразделение организации, в котором будет создана учётная запись Active Directory. Изменение подразделения организации не поддерживается. Объект необходимо удалить и создать заново.
password псевдонимы: pass string	Пароль указанного пользователя.
state string	Должна ли существовать служба Active Directory. Варианты: `"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, если модуль его поддерживает. Если параметр 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, а аутентификация по сертификату должна быть включена.
validate_certs boolean	Если задано значение `no`, SSL-сертификаты проверяться не будут. Значение `False` следует использовать только на контролируемых вами ресурсах с самоподписанными сертификатами. Варианты: `false` `true` ← (по умолчанию)
vserver string / обязательный	Имя используемого vserver.

Примечания

Примечание

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

Примеры

- name: Create active directory account.
  netapp.ontap.na_ontap_active_directory:
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: false
    vserver: laurentncluster-1
    state: present
    account_name: carchi
    admin_password: password
    admin_username: carchi
    domain: addomain.com

- name: Modify domain name.
  netapp.ontap.na_ontap_active_directory:
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: false
    vserver: laurentncluster-1
    state: present
    account_name: carchi
    admin_password: password
    admin_username: carchi
    domain: addomain_new.com
    force_account_overwrite: true

- name: Delete active directory account.
  netapp.ontap.na_ontap_active_directory:
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: false
    vserver: laurentncluster-1
    state: absent
    account_name: carchi
    admin_password: password
    admin_username: carchi
    domain: addomain.com

Авторы

Команда 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_active_directory_module.html