netapp.ontap.na_ontap_rest_cli – NetApp ONTAP Выполнить любую команду cli, пользователю необходимо разрешение на вход в консоль.
Примечание
Этот плагин входит в сборку netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в книге задач укажите: netapp.ontap.na_ontap_rest_cli.
Новое в версии 2.9.0: сборки netapp.ontap
Обзор
- Выполнение команд system-cli на 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»;
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| body словарь | словарь для спецификации информации | |
| cert_filepath строка добавлено в 20.6.0 netapp.ontap | путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6. | |
| command строка / обязательно | строковая команда. | |
| feature_flags словарь добавлено в 20.5.0 netapp.ontap | Включить или выключить новую функцию. Это может быть использовано для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Переопределить порт по умолчанию (80 или 443) этим портом | |
| https булево |
| Включить и выключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как требуется SSL. |
| key_filepath строка добавлено в 20.6.0 netapp.ontap | путь к файлу закрытого ключа SSL-клиента. | |
| ontapi целое число | Версия ontap api для использования | |
| params словарь | словарь параметров, передаваемых в вызов API | |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| use_rest строка | По умолчанию: "авто" | REST API, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае вернется к ZAPI. всегда -- всегда будет использовать REST API никогда -- всегда будет использовать ZAPI авто -- попытается использовать REST API |
| 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 на сайтах с личным контролем, использующих самозаверяющие сертификаты. |
| verb строка / обязательно |
| строка, указывающая, какой вызов API необходимо выполнить OPTIONS полезно для того, чтобы узнать, какие глаголы поддерживаются REST API |
Примечания
Примечание
- Модули с префиксом na_ontap разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: run ontap rest cli command
na_ontap_rest_cli:
hostname: "{{ hostname }}"
username: "{{ admin username }}"
password: "{{ admin password }}"
command: 'version'
verb: 'GET'
- name: run ontap rest cli command
na_ontap_rest_cli:
hostname: "{{ hostname }}"
username: "{{ admin username }}"
password: "{{ admin password }}"
command: 'security/login/motd'
verb: 'PATCH'
params: {'vserver': 'ansibleSVM'}
body: {'message': 'test'}
Авторы
- Команда 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_rest_cli_module.html
