Модуль netapp.ontap.na_ontap_lun_map — карты LUN NetApp ONTAP

Примечание

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

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

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

Чтобы использовать модуль в сценарии, укажите: netapp.ontap.na_ontap_lun_map.

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

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

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

Сопоставление и отмена сопоставления LUN в NetApp 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 string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
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.
hostname string / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределение порта по умолчанию (80 или 443) этим портом
https boolean	Включение и отключение https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по сертификату SSL, так как для нее требуется SSL. Варианты: `false` ← (по умолчанию) `true`
initiator_group_name string / обязательный	Группа инициаторов, сопоставляемая с указанным LUN.
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
lambda_config dictionary добавлено в netapp.ontap 23.4.0	Параметры конфигурации функции прокси-сервера AWS Lambda. Эти параметры и вложенные параметры поддерживаются только при использовании REST.
aws_profile string	Имя профиля AWS, используемого для аутентификации.
aws_region string / обязательный	Имя региона AWS.
function_name string / обязательный	Имя вызываемой функции AWS Lambda.
lun_id string	Идентификатор LUN, назначенный для сопоставления.
ontapi integer	Версия API ONTAP, которую следует использовать
password псевдонимы: pass string	Пароль указанного пользователя.
path string / обязательный	Путь к LUN. Для систем ASA r2 путь должен соответствовать формату <name>[@<snapshot-name>].
state string	Должен ли указанный LUN существовать. Варианты: `"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, выдается предупреждение. Если параметр модуля не поддерживается в REST, выдается ошибка. never — всегда использовать ZAPI, если модуль поддерживает ZAPI. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка. auto — использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае выполняется переход на 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.

Примечания

Примечание

Совместимо с системой ASA r2 при использовании REST для выпусков ONTAP 9.16.0x и более поздних.
Поддерживается функция прокси-сервера AWS Lambda при использовании REST. Примеры см. в файле README.
Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
По умолчанию https включен, и его рекомендуется использовать. Чтобы включить http в кластере, выполните следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Примеры

- name: Create LUN mapping
  netapp.ontap.na_ontap_lun_map:
    state: present
    initiator_group_name: ansibleIgroup3234
    path: /vol/iscsi_path/iscsi_lun
    vserver: ci_dev
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Unmap LUN
  netapp.ontap.na_ontap_lun_map:
    state: absent
    initiator_group_name: ansibleIgroup3234
    path: /vol/iscsi_path/iscsi_lun
    vserver: ci_dev
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
lun_naa_id string	Идентификатор Network Address Authority (NAA) для LUN. Возвращается: success Пример: `"600a0980383045372f5d4c5a70315474"`
lun_node string	Контроллер NetApp, на котором размещен LUN. (Примечание: не возвращается при использовании REST.) Возвращается: success Пример: `"node01"`
lun_ostype string	Указывает ОС хоста, обращающегося к LUN. Возвращается: success Пример: `"vmware"`
lun_serial string	Уникальная 12-байтовая строка ASCII, используемая для идентификации LUN. Возвращается: success Пример: `"80E7/]LZp1Tt"`
lun_size integer	Размер LUN в байтах. Возвращается: success Пример: `2199023255552`
lun_state string	Состояние LUN: в сети или вне сети. Возвращается: success Пример: `"online"`

Авторы

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