Spec-Zone.ru › Ansible

netapp.ontap.na_ontap_volume_autosize module – управление автоматическим изменением размера тома NetApp ONTAP

Примечание

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

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

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

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

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

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

Описание

  • Изменение параметров AutoSize тома

Требования

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

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

Параметры

Параметр

Комментарии

cert_filepath

string

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

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

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

feature_flags

dictionary

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

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

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

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

force_ontap_version

string

добавлено в 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.

grow_threshold_percent

integer

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

Порог увеличения по умолчанию варьируется от 85% до 98% в зависимости от размера тома.

Порог увеличения не может быть меньше или равен порогу уменьшения.

Диапазон от 0 до 100

hostname

string / обязательный

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

http_port

integer

Переопределяет порт по умолчанию (80 или 443), задавая этот порт.

https

boolean

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

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

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

Варианты:

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

increment_size

string

Задает размер приращения гибкого тома в следующем формате: < число > [k|m|g|t]

Указывается абсолютный размер.

Символы ‘k’, ‘m’, ‘g’ и ‘t’ в конце обозначают единицы измерения: ‘килобайты’, ‘мегабайты’, ‘гигабайты’ и ‘терабайты’ соответственно.

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

key_filepath

string

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

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

lambda_config

dictionary

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

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

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

aws_profile

string

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

aws_region

string / обязательный

Имя региона AWS.

function_name

string / обязательный

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

maximum_size

string

Задает максимально допустимый размер гибкого тома в следующем формате: < число > [k|m|g|t]

Указывается абсолютный размер.

Символы ‘k’, ‘m’, ‘g’ и ‘t’ в конце обозначают единицы измерения: ‘килобайты’, ‘мегабайты’, ‘гигабайты’ и ‘терабайты’ соответственно.

Значение по умолчанию на 20% превышает размер тома на момент включения автоматического изменения размера.

Максимальный размер тома не может быть меньше его текущего размера.

Максимальный размер также не может быть меньше или равен минимальному размеру.

minimum_size

string

Задает минимально допустимый размер гибкого тома в следующем формате: < число > [k|m|g|t]. Указывается абсолютный размер.

Символы ‘k’, ‘m’, ‘g’ и ‘t’ в конце обозначают единицы измерения: ‘килобайты’, ‘мегабайты’, ‘гигабайты’ и ‘терабайты’ соответственно.

Значение по умолчанию — размер тома на момент включения режима ‘grow_shrink’.

Минимальный размер не может быть больше или равен максимальному размеру.

mode

string

Задает режим автоматического изменения размера гибкого тома.

Варианты:

  • "grow"
  • "grow_shrink"
  • "off"

ontapi

integer

Версия API ONTAP, используемая модулем.

password

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

string

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

reset

boolean

Устанавливает для параметров maximum_size, increment_size, minimum_size, grow_threshold_percent, shrink_threshold_percent и mode значения по умолчанию.

Если указан параметр reset, система всегда выполняет сброс, поэтому идемпотентность не поддерживается.

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

Варианты:

  • false
  • true

shrink_threshold_percent

integer

Указывает процент емкости гибкого тома, при достижении которого начинается автоматическое уменьшение размера.

Порог уменьшения по умолчанию составляет 50%. Порог уменьшения не может быть больше или равен порогу увеличения.

Диапазон от 0 до 100

use_lambda

boolean

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

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

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

Варианты:

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

use_rest

string

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

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

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

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

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

username

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

string

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

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

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

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

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

validate_certs

boolean

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

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

Варианты:

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

volume

string / обязательный

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

vserver

string / обязательный

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

Примечания

Примечание

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

Примеры

- name: Modify volume autosize
  netapp.ontap.na_ontap_volume_autosize:
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    volume: ansibleVolumesize12
    mode: grow
    grow_threshold_percent: 99
    increment_size: 50m
    maximum_size: 10g
    minimum_size: 21m
    shrink_threshold_percent: 40
    vserver: ansible_vserver

- name: Reset volume autosize
  netapp.ontap.na_ontap_volume_autosize:
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    volume: ansibleVolumesize12
    reset: true
    vserver: ansible_vserver

Авторы

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

Spec-Zone.ru

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