Модуль netapp.ontap.na_ontap_lun_map – Карты LUN NetApp ONTAP
Примечание
Этот модуль является частью коллекции netapp.ontap (версия 22.12.0).
Вы, возможно, уже установили эту коллекцию, если используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля необходимы дополнительные требования, см. Требования для подробностей.
Для использования в playbook укажите: netapp.ontap.na_ontap_lun_map.
Новое в netapp.ontap 2.6.0
Обзор
- Настройка и отключение LUN в NetApp 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 added in netapp.ontap 20.6.0 | путь к файлу сертификата клиента SSL (.pem). не поддерживается с python 2.6. |
feature_flags dictionary added in netapp.ontap 20.5.0 | Включить или отключить новую функцию. Это может использоваться для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут меняться без уведомления. Неизвестные ключи игнорируются. |
force_ontap_version string added in netapp.ontap 21.23.0 | Переопределить версию ONTAP кластера при использовании REST. Поведение не определено, если версия не соответствует целевому кластеру. Это предоставляется в качестве временного решения, когда версию кластера невозможно прочитать из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Это должно быть в формате 9.10 или 9.10.1, где каждый элемент является целым числом. Когда Игнорируется с ZAPI. |
hostname string / required | Имя хоста или IP-адрес экземпляра ONTAP. |
http_port integer | Переопределить порт по умолчанию (80 или 443) этим портом |
https boolean | Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании проверки подлинности сертификата SSL, так как она требует SSL. Варианты:
|
initiator_group_name string / required | Группа инициаторов для сопоставления с заданным LUN. |
key_filepath string added in netapp.ontap 20.6.0 | путь к файлу закрытого ключа SSL. |
lun_id string | ID LUN, назначенный для сопоставления. |
ontapi integer | Версия API ontap для использования |
password aliases: pass string | Пароль для указанного пользователя. |
path string / required | Путь к LUN. |
state string | Должен ли существовать указанный LUN или нет. Варианты:
|
use_rest string | Использовать REST или ZAPI. always – всегда будет использовать REST API, если модуль поддерживает REST. Выдается предупреждение, если модуль не поддерживает REST. Выдается ошибка, если параметр модуля не поддерживается в REST. never – всегда будет использовать ZAPI, если модуль поддерживает ZAPI. Ошибка может быть выдана, если параметр REST не поддерживается в ZAPI. auto – будет пытаться использовать REST API, если модуль поддерживает REST и параметры модулей поддерживаются. В противном случае возвращается к ZAPI. По умолчанию: |
username aliases: user string | Это может быть учетная запись в масштабе кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Для получения дополнительной информации, пожалуйста, прочитайте документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации
Для использования сертификата сертификат должен быть установлен в кластере ONTAP, и должна быть включена аутентификация сертификатов. |
validate_certs boolean | Если установлено в Это следует устанавливать в Варианты:
|
vserver string / required | Имя vserver для использования. |
Примечания
Примечание
- Модули с префиксом na_ontap созданы для поддержки платформы хранения ONTAP.
- https включен по умолчанию и рекомендуется. Чтобы включить http в кластере, необходимо выполнить следующие команды «set -privilege advanced;» «system services web modify -http-enabled true;»
Примеры
- name: Create LUN mapping
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
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 строка | Идентификатор Network Address Authority (NAA) для LUN. Возвращается: успех Пример: |
lun_node строка | Контроллер NetApp, на котором размещен LUN. (Примечание. Не возвращается при использовании REST). Возвращается: успех Пример: |
lun_ostype строка | Определяет ОС хоста, обращающегося к LUN. Возвращается: успех Пример: |
lun_serial строка | Уникальная 12-байтовая ASCII-строка, используемая для идентификации LUN. Возвращается: успех Пример: |
lun_size целое число | Размер LUN в байтах. Возвращается: успех Пример: |
lun_state строка | Статус LUN — онлайн или офлайн. Возвращается: успех Пример: |
Ссылки на сборку
© 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_lun_map_module.html
