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

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 22.12.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 или более поздней версии.
При использовании ZAPI, netapp-lib 2018.11.13 или более поздней версии (установить с помощью «pip install netapp-lib»), strongly рекомендуется 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, где каждый элемент является целым числом. Когда `use_rest` установлено в auto, это может привести к переключению на ZAPI в зависимости от версии и возможностей платформы. Игнорируется при использовании ZAPI.
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-сервера, который система уведомлений событий использует для отправки электронных писем об событиях.
ontapi целое число	Используемая версия API ontap
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"` ← (по умолчанию)
use_rest строка	Использовать REST или ZAPI. always – всегда использует REST API, если модуль его поддерживает. Выдаётся предупреждение, если модуль не поддерживает REST. Выдаётся ошибка, если параметр модуля не поддерживается в REST. never – всегда использует ZAPI, если модуль его поддерживает. Может быть выдана ошибка, если параметр REST не поддерживается в ZAPI. auto – пытается использовать REST API, если модуль его поддерживает и параметры модуля поддерживаются. Иначе возвращается к ZAPI. По умолчанию: `"auto"`
username псевдонимы: user строка	Это может быть учётная запись на уровне кластера или SVM в зависимости от того, требуется ли API на уровне кластера или SVM. Для получения дополнительной информации обратитесь к документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации: аутентификация по протоколу basic, с использованием имени пользователя и пароля, аутентификация по SSL-сертификату, с использованием файла SSL-сертификата клиента и, необязательно, файла закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, а также должна быть включена аутентификация по сертификатам.

validate_certs

boolean

Если установлено в 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/netapp/ontap/na_ontap_ems_config_module.html