Модуль netapp.ontap.na_ontap_license – Лицензионные пакеты протоколов и функций NetApp ONTAP
Примечание
Этот модуль входит в коллекцию netapp.ontap (версия 22.12.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля необходимы дополнительные требования, см. Требования для подробностей.
Для использования в книге задач укажите: netapp.ontap.na_ontap_license.
Новая функция в netapp.ontap 2.6.0
Описание
- Добавление или удаление лицензионных пакетов в 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 строка добавлено в netapp.ontap 20.6.0 | путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6. |
feature_flags словарь добавлено в netapp.ontap 20.5.0 | Включить или отключить новую функцию. Это можно использовать для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. |
force_ontap_version строка добавлено в netapp.ontap 21.23.0 | Переопределить версию кластера ONTAP при использовании REST. Поведение не определено, если версия не соответствует целевому кластеру. Это предлагается как обходной путь, когда версия кластера не может быть прочитана из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Это должно быть в формате 9.10 или 9.10.1, где каждый элемент — целое число. Когда Игнорируется с ZAPI. |
hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. |
http_port целое число | Переопределить порт по умолчанию (80 или 443) на этот порт |
https булево | Включить и выключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как требуется SSL. Выбор:
|
key_filepath строка добавлено в netapp.ontap 20.6.0 | путь к файлу закрытого ключа SSL-клиента. |
license_codes список / элементы=строка | Список кодов лицензий, которые необходимо установить. |
license_names список / элементы=строка | Список имен пакетов лицензий для удаления. |
|
base строка |
Базовая лицензия кластера |
|
cdmi строка |
Лицензия CDMI |
|
cifs строка |
Лицензия CIFS |
|
fcp строка |
Лицензия FCP |
|
flexclone строка |
Лицензия FlexClone |
|
iscsi строка |
Лицензия iSCSI |
|
nfs строка |
Лицензия NFS |
|
snaplock строка |
Лицензия SnapLock |
|
snapmanagersuite строка |
Лицензия SnapManagerSuite |
|
snapmirror строка |
Лицензия SnapMirror |
|
snapprotectapps строка |
Лицензия SnapProtectApp |
|
snaprestore строка |
Лицензия SnapRestore |
|
snapvault строка |
Лицензия SnapVault |
|
v_storageattach строка |
Лицензия на виртуальное подключенное хранилище |
ontapi целое число | Версия ontap api для использования |
пароль псевдонимы: pass строка | Пароль для указанного пользователя. |
remove_expired булево | Удалить пакеты лицензий, срок действия которых истек в кластере. Не поддерживается с REST. Варианты:
|
remove_unused булево | Удалить пакеты лицензий, которые не имеют принадлежности к контроллеру в кластере. Не поддерживается с REST. Варианты:
|
serial_number строка | Серийный номер узла или кластера, связанного с пакетом лицензий. Этот параметр требуется при удалении пакета лицензий. С REST, ‘*’ принимается и соответствует любому серийному номеру. |
state строка | Указывает, должны ли быть установлены или удалены указанные пакеты лицензий. Варианты:
|
use_rest строка | Использовать 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 булево | Если установлено значение Это следует установить только в Варианты:
|
Примечания
Примечание
- Частично поддерживает режим check_mode — некоторые изменения нельзя обнаружить до выполнения действия добавления или удаления.
- Поддерживает ключи лицензий длиной 28 символов с помощью ZAPI и REST.
- Поддерживает версию файла лицензий NetApp 2 (NLFv2) с REST.
- Версия файла лицензий NetApp 1 (NLFv1) с REST в настоящее время не поддерживается, но может работать.
- Ansible пытается переформатировать файлы лицензий, поскольку содержимое похоже на python. Используйте строковый фильтр в случае проблем, чтобы отключить это поведение.
- Для этого модуля требуются пакеты python ast и json, если не используется строковый фильтр.
- Для проверки идемпотентности и удаления лицензий с помощью файла NLFv2 этот модуль требует пакета json.
- Для проверки идемпотентности этот модуль требует пакета deepdiff.
- Ни один из этих пакетов не требуется при использовании строкового фильтра, но модуль не будет идемпотентным.
- Модули, начинающиеся с префикса na_ontap, созданы для поддержки платформы хранения ONTAP.
- https включен по умолчанию и рекомендуется. Чтобы включить http в кластере, необходимо выполнить следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’
Примеры
- name: Add licenses - 28 character keys
netapp.ontap.na_ontap_license:
state: present
serial_number: #################
license_codes: CODE1,CODE2
- name: Remove licenses
netapp.ontap.na_ontap_license:
state: absent
remove_unused: false
remove_expired: true
serial_number: #################
license_names: nfs,cifs
- name: Add NLF licenses
netapp.ontap.na_ontap_license:
state: present
license_codes:
- "{{ lookup('file', nlf_filepath) | string }}"
- name: Remove NLF license bundle - using license file
netapp.ontap.na_ontap_license:
state: absent
license_codes:
- "{{ lookup('file', nlf_filepath) | string }}"
- name: Remove NLF license bundle - using bundle name
netapp.ontap.na_ontap_license:
state: absent
remove_unused: false
remove_expired: true
serial_number: #################
license_names: "Enterprise Edition"
Значения возврата
Общие значения возврата документированы здесь, следующие — поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
updated_licenses словарь | Возвращает список обновленных имен пакетов Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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_license_module.html
