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, где каждый элемент является целым числом. Если для Игнорируется при использовании 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. Варианты:
|
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 | Задает режим автоматического изменения размера гибкого тома. Варианты:
|
ontapi integer | Версия API ONTAP, используемая модулем. |
password псевдонимы: pass string | Пароль указанного пользователя. |
reset boolean | Устанавливает для параметров maximum_size, increment_size, minimum_size, grow_threshold_percent, shrink_threshold_percent и mode значения по умолчанию. Если указан параметр reset, система всегда выполняет сброс, поэтому идемпотентность не поддерживается. Не поддерживается в REST. Варианты:
|
shrink_threshold_percent integer | Указывает процент емкости гибкого тома, при достижении которого начинается автоматическое уменьшение размера. Порог уменьшения по умолчанию составляет 50%. Порог уменьшения не может быть больше или равен порогу увеличения. Диапазон от 0 до 100 |
use_lambda boolean добавлено в netapp.ontap 23.2.0 | Определяет, следует ли использовать прокси-функциональность AWS Lambda для подключения к системе ONTAP. Поддерживается только в REST. Варианты:
|
use_rest string | Определяет, использовать REST или ZAPI. always — всегда использовать REST API, если модуль его поддерживает. Если модуль не поддерживает REST, выдается предупреждение. Если параметр модуля не поддерживается в REST, выдается ошибка. never — всегда использовать ZAPI, если модуль его поддерживает. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка. auto — использовать REST API, если модуль его поддерживает и поддерживаются параметры модуля. В противном случае использовать ZAPI. По умолчанию: |
username псевдонимы: user string | Это может быть учетная запись с областью действия кластера или SVM — в зависимости от того, требуется ли API уровня кластера или SVM. Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два способа аутентификации:
Для использования сертификата его необходимо установить в кластере ONTAP, а аутентификацию по сертификату — включить. |
validate_certs boolean | Если задано значение Устанавливайте это значение в Варианты:
|
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
Ссылки на коллекцию
© 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