Модуль netapp.ontap.na_ontap_ems_config — модуль NetApp ONTAP для изменения конфигурации EMS.

Примечание

Этот модуль входит в состав коллекции netapp.ontap (версия 23.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля необходимы дополнительные компоненты; подробную информацию см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: netapp.ontap.na_ontap_ems_config.

Добавлен в netapp.ontap 22.8.0

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

Настройка уведомлений о событиях и ведения журналов для кластера.

Требования

На узле, выполняющем этот модуль, должны быть соблюдены следующие требования.

Ansible 2.9 или более поздней версии — рекомендуется версия 2.12 или более поздняя.
Python3 — рекомендуется версия 3.9 или более поздняя.
netapp-lib требуется только при использовании ZAPI (установите с помощью «pip install netapp-lib»). Обратите внимание: поддержка netapp-lib прекращена, и он больше не сопровождается. Используйте на свой страх и риск.
Физическая или виртуальная кластерная система 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, где каждый элемент — целое число.
hostname строка / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределяет порт по умолчанию (80 или 443), задавая этот порт.
https логическое значение	Включение и отключение HTTPS. Игнорируется при использовании REST, поскольку поддерживается только HTTPS. Игнорируется при использовании аутентификации с помощью сертификата SSL, так как для неё требуется SSL. Варианты: `false` ← (по умолчанию) `true`
key_filepath строка добавлен в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
mail_from строка	Адрес электронной почты, который система уведомлений о событиях использует в поле «От» для уведомлений по электронной почте.
mail_server строка	Имя или IP-адрес SMTP-сервера, который система уведомлений о событиях использует для отправки уведомлений о событиях по электронной почте.
password псевдонимы: pass строка	Пароль указанного пользователя.
proxy_password строка	Пароль для HTTP- или HTTPS-прокси.
proxy_url строка	URL-адрес HTTP- или HTTPS-прокси-сервера, используемый целевыми объектами уведомлений EMS типа rest-api, если в организации применяется прокси-сервер.
proxy_user строка	Имя пользователя для HTTP- или HTTPS-прокси-сервера, если требуется аутентификация.
pubsub_enabled логическое значение	Указывает, публикуются ли события в брокере сообщений Publish/Subscribe. Требуется ONTAP 9.10 или более поздняя версия. Варианты: `false` `true`
state строка	Изменение конфигурации EMS; поддерживается только состояние present. Варианты: `"present"` ← (по умолчанию)
use_lambda логическое значение добавлен в netapp.ontap 23.4.0	Указывает, следует ли использовать прокси-функцию AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты: `false` ← (по умолчанию) `true`
use_rest строка	Этот модуль поддерживает только REST. always — всегда использовать REST API. Если модуль не поддерживает REST, выводится предупреждение. По умолчанию: `"always"`
username псевдонимы: user строка	Это может быть учетная запись на уровне кластера или SVM — в зависимости от того, какой API требуется: на уровне кластера или SVM. Дополнительную информацию см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации. Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью сертификата SSL с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа. Чтобы использовать сертификат, его необходимо установить в кластере ONTAP и включить аутентификацию по сертификату.
validate_certs логическое значение	Если задано значение `no`, SSL-сертификаты не будут проверяться. Задавайте это значение только `False` на сайтах, которыми вы управляете лично и где используются самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Поддерживается только REST и требуется ONTAP 9.6 или более поздняя версия.
Модуль не является идемпотентным, если задан proxy_password.
Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
HTTPS включен по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, выполните следующие команды: «set -privilege advanced;» «system services web modify -http-enabled true;»

Примеры

- name: Modify EMS mail config
  netapp.ontap.na_ontap_ems_config:
    state: present
    mail_from: administrator@mycompany.com
    mail_server: mail.mycompany.com
    pubsub_enabled: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

- name: Modify EMS proxy config
  netapp.ontap.na_ontap_ems_config:
    state: present
    proxy_url: http://proxy.example.com:8080
    pubsub_enabled: true
    proxy_user: admin
    proxy_password: password
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

Авторы

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