Spec-Zone.ru › Ansible

netapp.ontap.na_ontap_qos_policy_group модуль — Управление группой QoS-политик в NetApp ONTAP.

Примечание

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

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

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

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

Новая функция в netapp.ontap 2.8.0

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

Описание

  • Создание, удаление, изменение или переименование группы QoS-политик в NetApp ONTAP.
  • С ZAPI поддерживается только фиксированная группа QoS-политик.
  • С REST поддерживаются как фиксированные, так и адаптивные группы QoS-политик.

Требования

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

  • Ansible 2.9 или более поздняя версия — рекомендуется версия 2.12 или более поздняя.
  • Python3 — рекомендуется версия 3.9 или более поздняя.
  • При использовании ZAPI, netapp-lib 2018.11.13 или более поздняя версия (установка с помощью ‘pip install netapp-lib’), а netapp-lib 2020.3.12 настоятельно рекомендуется, так как она обеспечивает лучшую обработку ошибок при подключении.
  • Физическая или виртуальная кластерная система Data ONTAP, модули поддерживают Data ONTAP 9.1 и выше, поддержка REST требует ONTAP 9.6 или более поздней версии.

Параметры

Параметр

Комментарии

adaptive_qos_options

словарь

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

Политики адаптивного QoS определяют измеримые цели уровня обслуживания (SLO), которые настраиваются в зависимости от занимаемого и выделенного пространства объекта хранения.

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

absolute_min_iops

целое число / обязательно

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

Эти минимальные значения не гарантируются на платформах, не поддерживающих AFF, или при установке политик тиеринга FabricPool.

block_size

строка

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

Указывает размер блока.

Требуется ONTAP 9.10.1 или более поздняя версия.

Варианты:

  • "any"
  • "4k"
  • "8k"
  • "16k"
  • "32k"
  • "64k"
  • "128k"

expected_iops

целое число / обязательно

Ожидаемый показатель IOPS. Указывает минимальный ожидаемый показатель IOPS на ТБ выделенного пространства, в зависимости от размера выделенного пространства объекта хранения.

Эти минимальные значения не гарантируются на платформах, не поддерживающих AFF, или при установке политик тиеринга FabricPool.

expected_iops_allocation

строка

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

Указывает размер, который будет использоваться для расчета ожидаемого показателя IOPS на ТБ.

Поддерживается только через REST; требуется ONTAP 9.10.1 или более поздняя версия.

Варианты:

  • "used_space"
  • "allocated_space"

peak_iops

целое число / обязательно

Максимальный показатель IOPS. Указывает максимальный возможный показатель IOPS на ТБ выделенного пространства, в зависимости от размера выделенного или используемого пространства объекта хранения.

peak_iops_allocation

строка

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

Указывает размер, который будет использоваться для расчета максимального показателя IOPS на ТБ.

Поддерживается только через REST; требуется ONTAP 9.10.1 или более поздняя версия.

Варианты:

  • "used_space"
  • "allocated_space"

cert_filepath

строка

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

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

не поддерживается с python 2.6.

feature_flags

словарь

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

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

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

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

fixed_qos_options

словарь

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

Установить минимальную и максимальную пропускную способность, определенную этой политикой.

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

Требуется один из вариантов пропускной способности при создании политики qos_policy.

capacity_shared

логическое

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

Значение по умолчанию — False, если оно не используется при создании политики qos.

Варианты:

  • false
  • true

max_throughput_iops

целое число

Максимальная пропускная способность, определенная этой политикой. Выражается в IOPS.

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

max_throughput_mbps

целое число

Максимальная пропускная способность, определенная этой политикой. Выражается в Мбит/с.

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

min_throughput_iops

целое число

Минимальная пропускная способность, определенная этой политикой. Выражается в IOPS.

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

Эти минимальные значения не гарантируются на платформах, не поддерживающих AFF, или при установке политик тиеринга FabricPool.

min_throughput_mbps

целое число

Минимальная пропускная способность, определенная этой политикой. Выражается в Мбит/с.

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

Требуется ONTAP 9.8 или более поздняя версия, а также поддержка REST.

force

логическое

Установка в «true» принудительно удаляет рабочие нагрузки, связанные с политикой группы, а также саму политику группы.

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

Варианты:

  • false
  • true
END_OF_DOCUMENT_MARKER

force_ontap_version

string

added in 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_name

string

Имя существующей группы политик, которая должна быть переименована в name.

hostname

string / required

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

http_port

integer

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

https

boolean

Включить и отключить https.

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

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

Choices:

  • false ← (default)
  • true

is_shared

boolean

added in netapp.ontap 20.12.0

Определяет, являются ли SLO группы политик общими для рабочих нагрузок или SLO применяются отдельно к каждой рабочей нагрузке.

Не поддерживается с REST, используйте fixed_qos_options.

Choices:

  • false
  • true

key_filepath

string

added in netapp.ontap 20.6.0

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

max_throughput

string

Максимальная пропускная способность, определенная этой политикой.

Не поддерживается с REST, используйте fixed_qos_options.

min_throughput

string

Минимальная пропускная способность, определенная этой политикой.

Не поддерживается с REST, используйте fixed_qos_options.

name

string / required

Имя группы политик для управления.

ontapi

integer

Версия API ontap для использования

password

aliases: pass

string

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

state

string

Должна ли существовать указанная группа политик или нет.

Choices:

  • "present" ← (default)
  • "absent"

use_rest

string

Использовать REST или ZAPI.

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

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

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

Default: "auto"

username

aliases: user

string

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

Для получения дополнительной информации, пожалуйста, прочитайте документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/.

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

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

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

validate_certs

boolean

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

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

Choices:

  • false
  • true ← (default)

vserver

string / required

Имя vserver для использования.

Примечания

Примечание

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

Примеры

- name: create qos policy group in ZAPI.
  netapp.ontap.na_ontap_qos_policy_group:
    state: present
    name: policy_1
    vserver: policy_vserver
    max_throughput: 800KB/s,800iops
    min_throughput: 100iops
    hostname: 10.193.78.30
    username: admin
    password: netapp1!
    use_rest: never

- name: modify qos policy group max throughput in ZAPI.
  netapp.ontap.na_ontap_qos_policy_group:
    state: present
    name: policy_1
    vserver: policy_vserver
    max_throughput: 900KB/s,800iops
    min_throughput: 100iops
    hostname: 10.193.78.30
    username: admin
    password: netapp1!
    use_rest: never

- name: delete qos policy group
  netapp.ontap.na_ontap_qos_policy_group:
    state: absent
    name: policy_1
    vserver: policy_vserver
    hostname: 10.193.78.30
    username: admin
    password: netapp1!

- name: create qos policy group in REST.
  netapp.ontap.na_ontap_qos_policy_group:
    state: present
    name: policy_1
    vserver: policy_vserver
    hostname: 10.193.78.30
    username: admin
    password: netapp1!
    use_rest: always
    fixed_qos_options:
      max_throughput_iops: 800
      max_throughput_mbps: 200
      min_throughput_iops: 500
      min_throughput_mbps: 100
      capacity_shared: True

- name: modify qos policy max_throughput in REST.
  netapp.ontap.na_ontap_qos_policy_group:
    state: present
    name: policy_1
    vserver: policy_vserver
    hostname: 10.193.78.30
    username: admin
    password: netapp1!
    use_rest: always
    fixed_qos_options:
      max_throughput_iops: 1000
      max_throughput_mbps: 300

- name: create adaptive qos policy group in REST.
  netapp.ontap.na_ontap_qos_policy_group:
    state: present
    name: adaptive_policy
    vserver: policy_vserver
    hostname: 10.193.78.30
    username: admin
    password: netapp1!
    use_rest: always
    adaptive_qos_options:
      absolute_min_iops: 100
      expected_iops: 200
      peak_iops: 500

- name: modify adaptive qos policy group in REST.
  netapp.ontap.na_ontap_qos_policy_group:
    state: present
    name: adaptive_policy
    vserver: policy_vserver
    hostname: 10.193.78.30
    username: admin
    password: netapp1!
    use_rest: always
    adaptive_qos_options:
      expected_iops_allocation: used_space
      peak_iops_allocation: allocated_space

Авторы

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

Spec-Zone.ru

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