Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_autosupport — AutoSupport NetApp ONTAP

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля могут потребоваться дополнительные компоненты. Подробнее см. в разделе Требования.

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

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

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

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

  • Включение/отключение AutoSupport

Требования

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

  • 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

string

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

Путь к файлу сертификата клиента SSL (.pem).

Не поддерживается в Python 2.6.

feature_flags

dictionary

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

Включение или отключение новой функции.

Параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость.

Поддерживаемые ключи и значения могут изменяться без уведомления. Неизвестные ключи игнорируются.

force

boolean

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

Установите флаг force в значение true, чтобы изменить некоторые параметры AutoSupport, изменение которых в противном случае заблокировано при включённой функции автоматического обновления.

Если для этого флага не задано значение true, попытка отключить AutoSupport, изменить транспорт на SMTP или отключить функцию AutoSupport OnDemand завершается ошибкой, когда включена функция автоматического обновления.

Варианты:

  • false
  • true

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.

from_address

string

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

Укажите адрес электронной почты, с которого узел отправляет сообщения AutoSupport.

hostname

string / обязательный

Имя хоста или IP-адрес экземпляра ONTAP.

hostname_in_subject

boolean

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

Укажите, включать ли имя хоста узла в тему сообщения AutoSupport.

Поддерживается только при использовании ZAPI.

Варианты:

  • false
  • true

http_port

integer

Переопределяет порт по умолчанию (80 или 443).

https

boolean

Включает и отключает https.

Игнорируется при использовании REST, так как поддерживается только https.

Игнорируется при использовании аутентификации с сертификатом SSL, поскольку для неё требуется SSL.

Варианты:

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

is_minimal

boolean

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

Указывает, собираются ли сведения о системе в соответствии с требованиями, чтобы удалить личные данные, или в полном объёме для расширенной диагностики.

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

Варианты:

  • false
  • true

key_filepath

string

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

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

local_collection_enabled

boolean

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

Указывает, следует ли собирать данные AutoSupport, когда служба AutoSupport отключена.

Поддерживается только при использовании ZAPI.

Варианты:

  • false
  • true

mail_hosts

list / элементы=string

Список почтовых серверов, используемых для доставки сообщений AutoSupport через SMTP.

В качестве допустимого значения можно указать как имена хостов, так и IP-адреса.

max_http_size

integer

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

Указывает ограничение на размер передаваемых данных для транспортного протокола HTTP (в байтах).

Поддерживается только при использовании ZAPI.

max_smtp_size

integer

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

Указывает ограничение на размер передаваемых данных для транспортного протокола SMTP (в байтах).

Поддерживается только при использовании ZAPI.

nht_data_enabled

boolean

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

Указывает, следует ли включать данные о состоянии дисков в данные AutoSupport.

Поддерживается только при использовании ZAPI.

Варианты:

  • false
  • true

node_name

string

Имя системы хранения, которой принадлежит конфигурация AutoSupport.

Поддерживается только при использовании ZAPI.

noteto

list / элементы=string

Указывает до пяти получателей кратких сообщений AutoSupport по электронной почте.

Поддерживается только при использовании ZAPI.

ondemand_enabled

boolean

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

Указывает, включена ли функция загрузки AutoSupport OnDemand.

Варианты:

  • false
  • true

ontapi

integer

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

partner_addresses

list / элементы=string

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

Указывает до пяти получателей из числа партнёров-поставщиков для полных сообщений AutoSupport по электронной почте.

password

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

string

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

perf_data_enabled

boolean

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

Указывает, следует ли включать данные о производительности в данные AutoSupport.

Поддерживается только при использовании ZAPI.

Варианты:

  • false
  • true

post_url

string

URL для доставки сообщений AutoSupport с помощью HTTP POST.

Поддерживается только при использовании ZAPI.

private_data_removed

boolean

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

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

Поддерживается только при использовании ZAPI.

Варианты:

  • false
  • true

proxy_url

string

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

Укажите прокси HTTP или HTTPS, если для параметра «transport» задано значение HTTP или HTTPS и в вашей организации используется прокси.

Если требуется аутентификация, используйте формат «username:password@host:port».

reminder_enabled

boolean

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

Указывает, включены или отключены напоминания AutoSupport.

Поддерживается только при использовании ZAPI.

Варианты:

  • false
  • true

retry_count

integer

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

Указывает максимальное количество попыток доставки сообщения AutoSupport.

Поддерживается только при использовании ZAPI.

smtp_encryption

string

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

Протокол шифрования, используемый для доставки сообщений AutoSupport по SMTP на настроенные серверы mail_hosts.

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

Варианты:

  • "none"
  • "start_tls"

state

string

Указывает, следует ли включить или отключить службу AutoSupport.

Если этот параметр не задан, доставка всех сообщений AutoSupport отключается.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

support

boolean

Указывает, включены ли уведомления AutoSupport для службы технической поддержки.

Варианты:

  • false
  • true

to_addresses

list / элементы=string

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

Указывает до пяти получателей полных сообщений AutoSupport по электронной почте.

transport

string

Название транспортного протокола, используемого для доставки сообщений AutoSupport.

Варианты:

  • "http"
  • "https"
  • "smtp"

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 ← (по умолчанию)

validate_digital_certificate

boolean

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

Если задано значение true, каждый узел будет проверять получаемые цифровые сертификаты.

Поддерживается только при использовании ZAPI.

Варианты:

  • false
  • true

Примечания

Примечание

  • Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
  • https включён по умолчанию и рекомендуется к использованию. Чтобы включить http в кластере, выполните следующие команды ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Примеры

- name: Enable autosupport - ZAPI
  netapp.ontap.na_ontap_autosupport:
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    state: present
    node_name: test
    transport: https
    noteto: abc@def.com,def@ghi.com
    mail_hosts: 1.2.3.4,5.6.7.8
    support: false
    post_url: url/1.0/post

- name: Modify autosupport proxy_url with password - ZAPI
  netapp.ontap.na_ontap_autosupport:
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    state: present
    node_name: test
    transport: https
    proxy_url: username:password@host.com:8000

- name: Modify autosupport proxy_url without password - ZAPI
  netapp.ontap.na_ontap_autosupport:
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    state: present
    node_name: test
    transport: https
    proxy_url: username@host.com:8000

- name: Disable autosupport - ZAPI
  netapp.ontap.na_ontap_autosupport:
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    state: absent
    node_name: test

- name: Enable autosupport - REST
  netapp.ontap.na_ontap_autosupport:
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    transport: https
    mail_hosts: 1.2.3.4,5.6.7.8
    proxy_url: proxyhost.local.com
    to_addresses: rst@xyz.com
    from_address: testmail1@abc.com
    ondemand_enabled: true
    support: true
    state: present
    force: true
    is_minimal: true
    smtp_encryption: none
    partner_addresses: test2@xyz.com

- name: Modify autosupport - REST
  netapp.ontap.na_ontap_autosupport:
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    transport: smtp
    mail_hosts: 1.2.3.4:25
    proxy_url: proxyhost.local.com
    to_addresses: rst@xyz.com,mymail@abc.com
    from_address: testmail@abc.com
    ondemand_enabled: false
    support: false
    state: present
    is_minimal: false
    smtp_encryption: start_tls
    partner_addresses: test1@xyz.com
    force: true

- name: Disable autosupport - REST
  netapp.ontap.na_ontap_autosupport:
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    state: absent

Авторы

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

Spec-Zone.ru

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