netapp.ontap.na_ontap_lun_map – NetApp ONTAP LUN maps
Примечание
Этот плагин входит в состав коллекции netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в playbook, укажите: netapp.ontap.na_ontap_lun_map.
Добавлен в версии 2.6.0: модуля netapp.ontap
Обзор
- Сопоставление и отключение LUN на NetApp ONTAP.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и выше.
- Поддержка REST требует ONTAP 9.6 или более поздней версии.
- Ansible 2.6
- Настоятельно рекомендуется использовать Ansible 2.9 или более позднюю версию, так как она позволяет использовать новую систему доставки коллекций.
- Python2 netapp-lib (2017.10.30) или более поздняя версия. Установите с помощью ‘pip install netapp-lib’
- Python3 netapp-lib (2018.11.13) или более поздняя версия. Установите с помощью ‘pip install netapp-lib’
- netapp-lib 2020.3.12 настоятельно рекомендуется, поскольку он обеспечивает лучшую обработку ошибок при подключении.
- Для включения http в кластере необходимо выполнить следующие команды ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cert_filepath строка добавлен в 20.6.0 netapp.ontap | Путь к файлу сертификата SSL клиента (.pem). не поддерживается с Python 2.6. | |
| feature_flags словарь добавлен в 20.5.0 netapp.ontap | Включить или отключить новую функцию. Это может быть использовано для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Заменить порт по умолчанию (80 или 443) на этот порт. | |
| https булево |
| Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как она требует SSL. |
| initiator_group_name строка / обязательно | Группа инициаторов для сопоставления с данным LUN. | |
| key_filepath строка добавлен в 20.6.0 netapp.ontap | Путь к файлу ключа SSL клиента. | |
| lun_id строка | Идентификатор LUN, назначенный для сопоставления. | |
| ontapi целое число | Используемая версия API ONTAP. | |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| path строка / обязательно | Путь к LUN. | |
| state строка |
| Существование или отсутствие указанного LUN. |
| use_rest строка | По умолчанию: "auto" | API REST, если поддерживается целевой системой для всех ресурсов и атрибутов, требуемых модулем. В противном случае вернется к ZAPI. всегда -- всегда будет использовать API REST никогда -- всегда будет использовать ZAPI авто -- будет пытаться использовать API REST |
| username строка | Может быть учётная запись на уровне кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или SVM. Для получения дополнительной информации, пожалуйста, ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. Основная аутентификация, с использованием имени пользователя и пароля, 2. Аутентификация по SSL-сертификату, с использованием файла SSL-сертификата клиента и, по желанию, файла закрытого ключа. Для использования сертификата, он должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам. псевдонимы: user | |
| validate_certs булево |
| Если установлено в no, сертификаты SSL не будут проверены.Это следует устанавливать только в False при работе с сайтами, управляемыми вами, с самоподписанными сертификатами. |
| vserver строка / обязательно | Имя vserver для использования. |
Примечания
Примечание
- Модули с префиксом na\_ontap разработаны для поддержки платформы хранения ONTAP.
Примеры
- 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. Пример: 600a0980383045372f5d4c5a70315474 |
| lun_node строка | успех | Контроллер NetApp, на котором размещается LUN. Пример: node01 |
| lun_ostype строка | успех | Указывает операционную систему хоста, обращающегося к LUN. Пример: vmware |
| lun_serial строка | успех | Уникальная 12-байтовая ASCII-строка, используемая для идентификации LUN. Пример: 80E7/]LZp1Tt |
| lun_size целое число | успех | Размер LUN в байтах. Пример: 2199023255552 |
| lun_state строка | успех | Статус LUN: онлайн или офлайн. Пример: online |
Авторы
- Команда NetApp Ansible (@carchi8py) <ng-ansibleteam@netapp.com>
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/netapp/ontap/na_ontap_lun_map_module.html
