Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_qos_policy_group — управление группой политик качества обслуживания NetApp ONTAP.

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 23.5.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 или более поздняя.
  • Python 3 — рекомендуется версия 3.9 или более поздняя.
  • netapp-lib требуется только при использовании ZAPI (установите с помощью «pip install netapp-lib»). Обратите внимание, что netapp-lib объявлен устаревшим и больше не поддерживается. Используйте его на свой страх и риск.
  • Физическая или виртуальная кластерная система 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 группы политик совместно использоваться рабочими нагрузками или применяться отдельно к каждой рабочей нагрузке.

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

Варианты:

  • 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

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.

from_name

строка

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

hostname

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

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

http_port

целое число

Заменяет порт по умолчанию (80 или 443) указанным портом.

https

логическое значение

Включение и отключение HTTPS.

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

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

Варианты:

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

is_shared

логическое значение

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

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

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

Варианты:

  • 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.

max_throughput

строка

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

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

min_throughput

строка

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

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

name

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

Имя группы политик, которой нужно управлять.

ontapi

целое число

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

password

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

строка

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

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.

Примечания

Примечание

  • При использовании REST поддерживается функция прокси-сервера AWS Lambda. Примеры см. в файле README.
  • Модули с префиксом 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: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    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: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    use_rest: never

- name: Delete qos policy group
  netapp.ontap.na_ontap_qos_policy_group:
    state: absent
    name: policy_1
    vserver: policy_vserver
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Create qos policy group in REST.
  netapp.ontap.na_ontap_qos_policy_group:
    state: present
    name: policy_1
    vserver: policy_vserver
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    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: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    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: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    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: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    use_rest: always
    adaptive_qos_options:
      expected_iops_allocation: used_space
      peak_iops_allocation: allocated_space

Авторы

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

Spec-Zone.ru

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