Spec-Zone.ru › Ansible

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

Варианты:

  • "krb_unix"
  • "win_unix"
  • "unix_win"
  • "s3_unix"
  • "s3_win"

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.

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.

Варианты:

  • false ← (по умолчанию)
  • true

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

Должны ли существовать указанные сопоставления имен или нет.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

use_rest

string

Использовать REST или ZAPI.

always – всегда будет использовать REST API, если модуль поддерживает REST. Предупреждение выдается, если модуль не поддерживает REST. Ошибка выдается, если параметр модуля не поддерживается в REST.

never – всегда будет использовать ZAPI, если модуль поддерживает ZAPI. Ошибка может быть выдана, если параметр REST не поддерживается в ZAPI.

auto – попытается использовать REST API, если модуль поддерживает REST и параметры модулей поддерживаются. В противном случае возвращается к ZAPI.

По умолчанию: "auto"

логин

псевдонимы: user

строка

Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или SVM.

Для получения дополнительной информации, пожалуйста, прочитайте документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/.

Поддерживаются два метода аутентификации

  1. базовая аутентификация, с использованием имени пользователя и пароля,
  2. аутентификация по сертификату SSL, с использованием файла сертификата клиента ssl и, необязательно, файла закрытого ключа.

Для использования сертификата сертификат должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам.

validate_certs

логическое значение

Если установлено значение no, сертификаты SSL не будут проверяться.

Это следует устанавливать только в False на сайтах, контролируемых лично, использующих самозаверяемые сертификаты.

Выбор:

  • false
  • true ← (по умолчанию)

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 }}"

Авторы

  • Команда NetApp Ansible (@carchi8py)

Ссылки на сборку

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (Исходные коды)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API