Модуль netapp.ontap.na_ontap_name_mappings — сопоставления имён NetApp ONTAP

Примечание

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

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

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

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

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

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

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

Создание, удаление и изменение сопоставлений имён для SVM в 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.
client_match строка	IP-адрес рабочей станции клиента, который используется для сопоставления с шаблоном при поиске. Пример: «10.254.101.111/28» Значение client_match может иметь один из следующих форматов: IPv4-адрес с маской подсети, заданной числом битов, например 10.1.12.0/24; IPv6-адрес с маской подсети, заданной числом битов, например fd20:8b1e:b255:4071::/64; IPv4-адрес с сетевой маской, например 10.1.16.0/255.255.255.0; имя хоста.
direction строка / обязательный	Направление применения сопоставления имён. Возможные значения: krb_unix — сопоставление имени участника Kerberos с именем пользователя UNIX; win_unix — сопоставление имени пользователя Windows с именем пользователя UNIX; unix_win — сопоставление имени пользователя UNIX с именем пользователя Windows; s3_unix — сопоставление имени пользователя S3 с именем пользователя UNIX; s3_win — сопоставление имени пользователя S3 с именем пользователя Windows. Для s3_unix и s3_win требуется ONTAP 9.12.1 или более поздняя версия. Варианты: `"krb_unix"` `"win_unix"` `"unix_win"` `"s3_unix"` `"s3_win"`
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, где каждый элемент является целым числом.
from_index целое число	Если запись с указанным индексом не найдена, она создаётся путём перенумерации записи с индексом from_index. Если запись не найдена ни для index, ни для from_index, сообщается об ошибке. Минимальное значение — 1, максимальное — 2147483647. Требуется ONTAP версии 9.7 или более поздней.
hostname строка / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределяет порт по умолчанию (80 или 443), указывая этот порт.
https логическое значение	Включение и отключение HTTPS. Игнорируется при использовании REST, поскольку поддерживается только HTTPS. Игнорируется при использовании аутентификации с сертификатом SSL, так как для неё требуется SSL. Варианты: `false` ← (по умолчанию) `true`
index целое число / обязательный	Позиция в списке сопоставлений имён. Минимальное значение — 1, максимальное — 2147483647.
key_filepath строка добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
lambda_config словарь добавлено в netapp.ontap 23.5.0	Параметры конфигурации функции прокси-сервера AWS Lambda. Этот параметр и его вложенные параметры поддерживаются только при использовании REST.
aws_profile строка	Имя профиля AWS, используемого для аутентификации.
aws_region строка / обязательный	Название региона AWS.
function_name строка / обязательный	Имя вызываемой функции AWS Lambda.
password псевдонимы: pass строка	Пароль указанного пользователя.
pattern строка	Шаблон, используемый для сопоставления имени при поиске имени, которое можно использовать в качестве замены. Шаблон представляет собой регулярное выражение в стиле UNIX. Регулярные выражения не учитывают регистр при сопоставлении Windows с UNIX и учитывают регистр при сопоставлении Kerberos с UNIX и UNIX с Windows. Минимальная длина — 1, максимальная — 256. Шаблон должен быть уникальным для каждого индекса vserver. Пример: ENGCIFS_AD_USER.
replacement строка	Имя, используемое в качестве замены, если шаблон, связанный с этой записью, совпадает. Минимальная длина — 1, максимальная — 256. Пример: unix_user1.
state строка	Должны ли указанные сопоставления имён существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_lambda логическое значение добавлено в netapp.ontap 23.4.0	Указывает, следует ли использовать функцию прокси-сервера AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты: `false` ← (по умолчанию) `true`
use_rest строка	Этот модуль поддерживает только REST. always — всегда использовать REST API. Если модуль не поддерживает REST, выдаётся предупреждение. По умолчанию: `"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.

Примечания

Примечание

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

Примеры

- name: Create name mappings configuration
  netapp.ontap.na_ontap_name_mappings:
    vserver: vserverName
    direction: win_unix
    index: 1
    pattern: ENGCIFS_AD_USER
    replacement: unix_user
    client_match: 10.254.101.111/28
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Modify name mappings configuration
  netapp.ontap.na_ontap_name_mappings:
    vserver: vserverName
    direction: win_unix
    index: 1
    pattern: ENGCIFS_AD_USERS
    replacement: unix_user1
    client_match: 10.254.101.112/28
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Swap name mappings position
  netapp.ontap.na_ontap_name_mappings:
    vserver: vserverName
    direction: win_unix
    index: 1
    pattern: ENGCIFS_AD_USERS
    replacement: unix_user1
    from_index: 2
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete name mappings configuration
  netapp.ontap.na_ontap_name_mappings:
    vserver: vserverName
    direction: win_unix
    index: 1
    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_name_mappings_module.html