Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_efficiency_policy — управление политиками эффективности NetApp ONTAP (политики SIS)

Примечание

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

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

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

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

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

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

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

  • Создание, изменение и удаление политик эффективности (политик SIS)

Требования

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

  • Ansible 2.9 или новее; рекомендуется версия 2.12 или новее.
  • Python 3; рекомендуется версия 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.

changelog_threshold_percent

целое число

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

Задает процент заполнения, при достижении которого будет обработан журнал изменений для политики типа threshold; проверка выполняется раз в час.

comment

строка

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

duration

строка

Длительность в часах, в течение которой должна выполняться запланированная операция эффективности. По истечении этого времени операция эффективности будет остановлена, даже если она не завершена. Если указано «-», операция эффективности будет выполняться до завершения. В противном случае длительность должна быть целым числом больше 0. По умолчанию операция выполняется до завершения.

enabled

логический

Если значение равно true, политика эффективности активна в этом кластере. Если значение равно false, планировщики не будут активировать эту политику, и она будет неактивна.

Варианты:

  • false
  • true

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.

lambda_config

словарь

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

Параметры конфигурации функции прокси-сервера AWS Lambda.

Эти параметры и вложенные параметры поддерживаются только при использовании REST.

aws_profile

строка

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

aws_region

строка / обязательный

Название региона AWS.

function_name

строка / обязательный

Имя вызываемой функции AWS Lambda.

ontapi

целое число

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

password

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

строка

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

policy_name

строка / обязательный

Имя политики эффективности.

policy_type

строка

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

(Обработка журнала изменений выявляет и удаляет повторяющиеся блоки, записанные с момента последней обработки журнала.)

Для типа threshold обработка журнала изменений выполняется, когда он заполнен до определенного процента.

Для типа scheduled обработка журнала изменений запускается по расписанию.

Варианты:

  • "threshold"
  • "scheduled"

qos_policy

строка

Политика QoS для операции эффективности.

Операция эффективности с параметром background выполняется в фоновом режиме с минимальным влиянием на операции обслуживания клиентов или без такого влияния.

Операции эффективности с параметром best-effort могут в некоторой степени повлиять на операции обслуживания клиентов.

Варианты:

  • "background"
  • "best_effort"

schedule

строка

Имя расписания задания типа cron. Если связанная политика назначена тому, операция эффективности для этого тома будет запускаться по этому расписанию.

Эти расписания можно создавать с помощью модуля na_ontap_job_schedule.

state

строка

Определяет, должна ли указанная политика эффективности существовать.

Варианты:

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

use_lambda

логический

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

Определяет, следует ли использовать функцию прокси-сервера AWS Lambda для подключения к системе ONTAP.

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

Варианты:

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

use_rest

строка

Определяет, использовать REST или ZAPI.

always — всегда использовать REST API, если модуль поддерживает REST. Если модуль не поддерживает REST, выдается предупреждение. Если параметр модуля не поддерживается в REST, выдается ошибка.

never — всегда использовать ZAPI, если модуль поддерживает ZAPI. Может быть выдана ошибка, если параметр REST не поддерживается в ZAPI.

auto — пытаться использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае используется ZAPI.

По умолчанию: "always"

username

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

строка

Это может быть учетная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или уровня SVM.

Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html.

Поддерживаются два метода аутентификации.

  1. Базовая аутентификация с использованием имени пользователя и пароля.
  2. Аутентификация по сертификату SSL с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа.

Для использования сертификата его необходимо установить в кластере ONTAP и включить аутентификацию по сертификату.

validate_certs

логический

Если задано значение no, сертификаты SSL не будут проверяться.

Устанавливайте это значение только для False на контролируемых вами сайтах, использующих самоподписанные сертификаты.

Варианты:

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

vserver

строка / обязательный

Имя используемого vserver.

Примечания

Примечание

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

Примеры

- name: Create threshold efficiency policy
  netapp.ontap.na_ontap_efficiency_policy:
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    vserver: ansible
    state: present
    policy_name: test
    comment: This policy is for x and y
    enabled: true
    policy_type: threshold
    qos_policy: background
    changelog_threshold_percent: 20

- name: Create Scheduled efficiency Policy
  netapp.ontap.na_ontap_efficiency_policy:
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    vserver: ansible
    state: present
    policy_name: test2
    comment: This policy is for x and y
    enabled: true
    schedule: new_job_schedule
    duration: 1
    policy_type: scheduled
    qos_policy: background

Авторы

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

Spec-Zone.ru

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