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

Примечание

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

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

Для использования в книге задач укажите: netapp.ontap.na_ontap_wait_for_condition.

Новое в версии 20.8.0: из netapp.ontap

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

Обзор

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

Требования

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

Ansible 2.9
Python3 netapp-lib (2018.11.13) или более поздней версии. Установите с помощью «pip install netapp-lib»
netapp-lib 2020.3.12 настоятельно рекомендуется, так как он обеспечивает более подробные сообщения об ошибках при проблемах с подключением.
Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии.
Поддержка REST требует ONTAP 9.6 или более поздней версии.
Для включения 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	требуется ли наличие или отсутствие условий. если `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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/netapp/ontap/na_ontap_wait_for_condition_module.html