netapp.ontap.na_ontap_wait_for_condition – NetApp ONTAP wait_for_condition. Цикл по запросу состояния до тех пор, пока не будет выполнено условие.

Примечание

Этот плагин входит в состав коллекции netapp.ontap (версия 20.12.0).

Для его установки используйте: ansible-galaxy collection install netapp.ontap.

Чтобы использовать его в книге задач, укажите: netapp.ontap.na_ontap_wait_for_condition.

Добавлена в версии 20.8.0: из netapp.ontap

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Цикл по запросу состояния ONTAP до тех пор, пока не будет удовлетворено условие.
Отчет об ошибке таймаута, если timeout превысит время ожидания условия.

Требования

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

Физическая или виртуальная кластеризованная система 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;»

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
attributes словарь		Словарь пользовательских атрибутов для события. Например, `sp_upgrade`, `sp_version` требуют `node`. `sp_version` требует `expectd_version`.
cert_filepath строка добавлено в 20.6.0 netapp.ontap		путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6.
conditions список / элементы=строка / обязательно		одно или несколько условий для соответствия например, `is_in_progress` для `sp_upgrade`, `firmware_version` для `sp_version`.
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-клиента.
name строка / обязательно	Варианты: sp_upgrade sp_version	Имя события, которое необходимо проверить.
ontapi целое число		Версия API ontap для использования
password строка		Пароль для указанного пользователя. псевдонимы: pass
polling_interval целое число	Значение по умолчанию: 5	как часто проверять условия, в секундах.
state строка	Варианты: настоящий ← отсутствует	нужно ли, чтобы условия были настоящими или отсутствовали. Если `present`, модуль завершает работу, когда наблюдается любое из условий. Если `absent`, модуль завершается успешно, когда не наблюдается ни одно из условий.
timeout целое число	Значение по умолчанию: 180	сколько времени ждать условий, в секундах.
use_rest строка	Значение по умолчанию: "auto"	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` используемых на лично контролируемых сайтах с использованием самозаверяющих сертификатов.

Примечания

Примечание

Модули, начинающиеся с префикса na\_ontap, разработаны для поддержки платформы ONTAP хранилищ.

Примеры

- name: wait for sp_upgrade in progress
  na_ontap_wait_for_condition:
    hostname: "{{ ontap_admin_ip }}"
    username: "{{ ontap_admin_username }}"
    password: "{{ ontap_admin_password }}"
    https: true
    validate_certs: no
    name: sp_upgrade
    conditions: is_in_progress
    attributes:
      node: "{{ node }}"
    polling_interval: 30
    timeout: 1800

- name: wait for sp_upgrade not in progress
  na_ontap_wait_for_condition:
    hostname: "{{ ontap_admin_ip }}"
    username: "{{ ontap_admin_username }}"
    password: "{{ ontap_admin_password }}"
    https: true
    validate_certs: no
    name: sp_upgrade
    conditions: is_in_progress
    state: absent
    attributes:
      node: "{{ ontap_admin_ip }}"
    polling_interval: 30
    timeout: 1800

- name: wait for sp_version to match 3.9
  na_ontap_wait_for_condition:
    hostname: "{{ ontap_admin_ip }}"
    username: "{{ ontap_admin_username }}"
    password: "{{ ontap_admin_password }}"
    https: true
    validate_certs: no
    name: sp_version
    conditions: firmware_version
    state: present
    attributes:
      node: "{{ ontap_admin_ip }}"
      expected_version: 3.9
    polling_interval: 30
    timeout: 1800

Возвращаемые значения

Общие возвращаемые значения описаны в здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое значение	Описание
last_state строка	всегда	последнее наблюдаемое состояние для события
states строка	всегда	обобщенный список наблюдаемых состояний во время ожидания завершения отчитывается при успешном завершении или ошибке таймаута

Авторы

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