netapp.ontap.na_ontap_name_mappings модуль — сопоставления имён NetApp ONTAP
Примечание
Этот модуль является частью коллекции netapp.ontap (версия 22.12.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 или более поздней версии, рекомендуется.
- При использовании 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 string добавлено в netapp.ontap 20.6.0 | путь к файлу сертификата клиента SSL (.pem). не поддерживается с python 2.6. |
client_match string | IP-адрес клиентской рабочей станции, который сопоставляется при поиске шаблона. Пример ‘10.254.101.111/28’ Значение сопоставления клиента может быть в одном из следующих форматов: - В виде IPv4-адреса с маской подсети, выраженной как количество бит; например, 10.1.12.0/24 - В виде IPv6-адреса с маской подсети, выраженной как количество бит; например, fd20:8b1e:b255:4071::/64 - В виде IPv4-адреса с сетевой маской; например, 10.1.16.0/255.255.255.0 - В виде имени хоста |
direction string / обязательный | Направление, в котором применяется сопоставление имен. Возможные значения: 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 или более поздней версии. Варианты:
|
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, где каждый элемент является целым числом. Когда Игнорируется с ZAPI. |
from_index integer | Если запись с индексом не найдена, она создается путем переиндексации записи для from_index. Если запись не найдена для index и from_index, сообщается об ошибке. Минимальное значение равно 1, а максимальное - 2147483647. Требуется версия ONTAP 9.7 или более поздняя. |
hostname string / обязательный | Имя хоста или IP-адрес экземпляра ONTAP. |
http_port integer | Переопределить порт по умолчанию (80 или 443) этим портом |
https boolean | Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании проверки подлинности сертификата SSL, так как она требует SSL. Варианты:
|
index integer / обязательный | Позиция в списке сопоставлений имен. Минимальное значение равно 1, а максимальное - 2147483647. |
key_filepath string добавлено в netapp.ontap 20.6.0 | путь к файлу ключа клиента SSL. |
ontapi integer | Используемая версия API ontap |
password псевдонимы: pass string | Пароль для указанного пользователя. |
pattern string | Шаблон, используемый для сопоставления имени при поиске имени, которое может использоваться в качестве замены. Шаблон представляет собой регулярное выражение в стиле UNIX. Регулярные выражения нечувствительны к регистру при сопоставлении из Windows в UNIX и чувствительны к регистру для сопоставлений из Kerberos в UNIX и из UNIX в Windows. Минимальная длина - 1, максимальная длина - 256. Шаблон должен быть уникальным для каждого индекса vserver. Пример ENGCIFS_AD_USER. |
replacement string | Имя, используемое в качестве замены, если связанный с этой записью шаблон соответствует. Минимальная длина - 1, максимальная длина - 256. Пример unix_user1. |
state string | Должны ли существовать указанные сопоставления имен или нет. Варианты:
|
use_rest string | Использовать REST или ZAPI. always – всегда будет использовать REST API, если модуль поддерживает REST. Предупреждение выдается, если модуль не поддерживает REST. Ошибка выдается, если параметр модуля не поддерживается в REST. never – всегда будет использовать ZAPI, если модуль поддерживает ZAPI. Ошибка может быть выдана, если параметр REST не поддерживается в ZAPI. auto – попытается использовать REST API, если модуль поддерживает REST и параметры модулей поддерживаются. В противном случае возвращается к ZAPI. По умолчанию: |
логин псевдонимы: user строка | Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или SVM. Для получения дополнительной информации, пожалуйста, прочитайте документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации
Для использования сертификата сертификат должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам. |
validate_certs логическое значение | Если установлено значение Это следует устанавливать только в Выбор:
|
vserver строка / обязательно | Имя vserver для использования. |
Примечания
Примечание
- Модули, начинающиеся с 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 }}"
Ссылки на сборку
© 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_name_mappings_module.html