Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_license — пакеты лицензий на протоколы и функции NetApp ONTAP

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 23.5.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 или новее.
  • Python 3 — рекомендуется версия 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

key_filepath

string

добавлено в netapp.ontap 20.6.0

Путь к файлу ключа клиента SSL.

license_codes

list / элементы типа string

Список кодов лицензий для установки.

license_names

list / элементы типа string

Список названий пакетов лицензий для удаления.

base

string

Базовая лицензия кластера

cdmi

string

Лицензия CDMI

cifs

string

Лицензия CIFS

fcp

string

Лицензия FCP

flexclone

string

Лицензия FlexClone

iscsi

string

Лицензия iSCSI

nfs

string

Лицензия NFS

snaplock

string

Лицензия SnapLock

snapmanagersuite

string

Лицензия SnapManagerSuite

snapmirror

string

Лицензия SnapMirror

snapprotectapps

string

Лицензия SnapProtectApp

snaprestore

string

Лицензия SnapRestore

snapvault

string

Лицензия SnapVault

v_storageattach

string

Лицензия Virtual Attached Storage

ontapi

integer

Версия API ONTAP, которую следует использовать.

password

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

string

Пароль указанного пользователя.

remove_expired

boolean

Удаляет пакеты лицензий, срок действия которых истёк в кластере.

Не поддерживается при использовании REST.

Варианты:

  • false
  • true

remove_unused

boolean

Удаляет пакеты лицензий, не связанные ни с одним контроллером в кластере.

Не поддерживается при использовании REST.

Варианты:

  • false
  • true

serial_number

string

Серийный номер узла или кластера, связанного с пакетом лицензий.

Этот параметр обязателен при удалении пакета лицензий.

В REST допускается значение «*», соответствующее любому серийному номеру.

state

string

Определяет, следует ли установить или удалить указанные пакеты лицензий.

Варианты:

  • "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.

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

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

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

validate_certs

boolean

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

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

Варианты:

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

Примечания

Примечание

  • Частично поддерживает check_mode: некоторые изменения невозможно обнаружить до выполнения действия добавления или удаления.
  • Поддерживает 28-символьные ключи лицензий при использовании ZAPI и REST.
  • Поддерживает NetApp License File Version 2 (NLFv2) при использовании REST.
  • NetApp License File Version 1 (NLFv1) при использовании REST сейчас не поддерживается, но может работать.
  • Ansible пытается преобразовать формат файлов лицензий, поскольку их содержимое похоже на код Python. При возникновении проблем используйте фильтр string, чтобы отключить это поведение.
  • Если фильтр string не используется, модулю требуются пакеты Python ast и json.
  • Модулю требуется пакет json для проверки идемпотентности и удаления лицензий с помощью файла NLFv2.
  • Модулю требуется пакет deepdiff для проверки идемпотентности.
  • При использовании фильтра string эти пакеты не требуются, однако модуль не будет идемпотентным.
  • Модули с префиксом 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

dictionary

Список обновлённых названий пакетов

Возвращается: всегда

Пример: "['nfs']"

Авторы

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

Spec-Zone.ru

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