na_ontap_volume – NetApp ONTAP управление томами
Новое в версии 2.6.
Описание
- Создание, удаление или изменение томов в NetApp ONTAP.
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и выше
- Ansible 2.6
- Python2 netapp-lib (2017.10.30) или более поздняя версия. Установка с помощью ‘pip install netapp-lib’
- Python3 netapp-lib (2018.11.13) или более поздняя версия. Установка с помощью ‘pip install netapp-lib’
- Для включения http в кластере необходимо выполнить следующие команды ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aggr_list список добавлен в 2.8 | массив имён агрегатов, используемых для компонентов FlexGroup. | |
| aggr_list_multiplier целое число добавлен в 2.8 | Количество итераций по агрегатам, перечисленным в параметре aggr_list, при создании FlexGroup. | |
| aggregate_name строка | Имя агрегата, на котором должен существовать flexvol. Требуется при state=present. | |
| atime_update логическое значение добавлен в 2.8 |
| Это параметр расширенного использования, значение по умолчанию True. Если false, предотвращает обновление времени доступа к узлам каталога при чтении файла. Это значение полезно для томов с очень большим объёмом чтений, так как предотвращает запись в файл узла каталога для тома, чтобы не мешать чтению из других файлов. Это поле следует использовать с осторожностью. То есть, используйте это поле, если заранее известно, что точное время доступа к узлам каталога не потребуется для файлов на этом томе. |
| auto_provision_as строка добавлен в 2.8 |
| Автоматически предоставляет том FlexGroup. |
| comment строка добавлен в 2.9 | Устанавливает комментарий, связанный с томом. | |
| efficiency_policy строка добавлен в 2.7 | Позволяет задать политику эффективности хранения при создании тома. | |
| encrypt логическое значение добавлен в 2.7 |
| Включить или выключить шифрование тома. |
| from_name строка добавлен в 2.7 | Имя существующего тома, который будет переименован в name. | |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Замените порт по умолчанию (80 или 443) на этот порт | |
| https логическое значение |
| Включить и выключить https |
| is_infinite логическое значение |
| Установите True, если том является бесконечным томом. Удаление бесконечного тома асинхронно. |
| is_online логическое значение |
| Том онлайн или нет. |
| junction_path строка | Путь соединения тома. Для размонтирования используйте путь соединения ''. | |
| language строка добавлен в 2.8 | Язык для использования в томе По умолчанию используется язык SVM Возможные значения Язык c POSIX ar Арабский cs Чешский da Датский de Немецкий en Английский en_us Английский (США) es Испанский fi Финский fr Французский he Иврит hr Хорватский hu Венгерский it Итальянский ja Японский euc-j ja_v1 Японский euc-j ja_jp.pck Японский PCK (sjis) ja_jp.932 Японский cp932 ja_jp.pck_v2 Японский PCK (sjis) ko Корейский no Норвежский nl Голландский pl Польский pt Португальский ro Румынский ru Русский sk Словацкий sl Словенский sv Шведский tr Турецкий zh Упрощенный китайский zh.gbk Упрощенный китайский (GBK) zh_tw Традиционный китайский euc-tw zh_tw.big5 Традиционный китайский Big 5 Для использования UTF-8 в качестве набора символов NFS добавьте '.UTF-8' к коду языка | |
| name строка / обязательно | Имя тома для управления. | |
| nvfail_enabled логическое значение добавлен в 2.9 |
| Если значение true, контроллер выполняет дополнительную работу при загрузке и перехвате, если обнаруживает потенциальную потерю данных в компонентах тома из-за сбоя NVRAM. Компоненты тома будут помещены в специальное состояние 'in-nvfailed-state', в результате чего доступ к протоколу будет заблокирован. Это приведет к завершению работы клиентских приложений и, таким образом, предотвратит доступ к устаревшим данным. Чтобы выйти из этой ситуации, администратор должен вручную очистить 'in-nvfailed-state' в компонентах тома. |
| ontapi целое число | Используемая версия API ontap | |
| password строка / обязательно | Пароль для указанного пользователя. псевдонимы: pass | |
| percent_snapshot_space целое число | Количество места, резервируемого для снимков тома. | |
| policy строка | Имя политики экспорта. | |
| qos_adaptive_policy_group - добавлен в 2.9 | Указывает группу адаптивных политик QoS, которая должна быть установлена на томе. | |
| qos_policy_group - добавлен в 2.9 | Указывает группу политик QoS, которая должна быть установлена на томе. | |
| size целое число | Размер тома в (size_unit). Требуется при state=present. | |
| size_unit строка |
| Единица измерения, используемая для интерпретации параметра size. |
| snapdir_access логическое значение добавлен в 2.8 |
| Это параметр расширенного использования, значение по умолчанию False. Включить видимую папку '.snapshot', которая обычно присутствует в системных точках монтирования. Это значение также включает доступ ко всем другим папкам '.snapshot' в томе. |
| snapshot_policy строка добавлен в 2.8 | Имя политики снимка. Имя политики по умолчанию 'default'. | |
| space_guarantee строка |
| Стиль гарантии места для тома. |
| space_slo string added in 2.9 |
| Указывает тип SLO пространства для тома. Тип SLO пространства — это целевой уровень обслуживания для управления пространством для тома. Значение space SLO используется для принудительного выполнения существующих настроек тома, чтобы обеспечить достаточное выделение пространства в агрегате для соответствия SLO пространства. Этот параметр не поддерживается для бесконечных томов. |
| state - |
| Указывает, должен ли указанный том существовать или нет. |
| tiering_policy string added in 2.9 |
| Политика тиеринга, которая должна быть связана с томом. Данная политика определяет, будут ли блоки тома распределены по уровню емкости. Политика snapshot-only позволяет распределение только снимков тома, которые не связаны с активной файловой системой. Политика auto позволяет распределение и снимков, и активных данных файловой системы пользователя на уровень емкости. Политика backup для томов DP позволяет всем переданным блокам данных пользователя начинать с уровня емкости. При значении none блоки тома не распределяются по уровню емкости. Если значение не указано, том назначается по умолчанию snapshot-only. |
| time_out integer added in 2.8 | Default: 180 | Время ожидания создания, изменения или удаления flexGroup в секундах. Прерывание запроса, если задача не завершена в заданное время. При значении 0 запрос является асинхронным. Значение по умолчанию составляет 3 минуты. |
| type string | Тип тома: чтение-запись (RW) или защита данных (DP). | |
| unix_permissions string added in 2.8 | Биты разрешений Unix в восьмеричном или символичном формате. Например, 0 эквивалентно ------------, 777 эквивалентно ---rwxrwxrwx, оба формата принимаются. Допустимое восьмеричное значение находится в диапазоне от 0 до 777 включительно. | |
| use_rest string |
| Использование REST API, если оно поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае используется ZAPI. Always — всегда использовать REST API. Never — всегда использовать ZAPI. Auto — попытка использования REST API. |
| username string / required | Может быть учётной записью кластерного или SVM-уровня в зависимости от того, требуется ли API кластерного или SVM-уровня. Дополнительную информацию можно найти в документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. псевдонимы: user | |
| validate_certs boolean |
| Если установлено в no, сертификаты SSL не будут проверены.Это должно быть установлено только в False на сайтах с собственными сертификатами. |
| volume_security_style string |
| Стиль безопасности, связанный с этим томом. |
| vserver string / required | Имя vserver для использования. | |
| vserver_dr_protection string added in 2.9 |
| Указывает тип защиты для тома в настройке DR Vserver. |
| wait_for_completion boolean added in 2.8 |
| Установите этот параметр в 'true' для синхронного выполнения при создании (подождите, пока состояние тома не станет online). Установите этот параметр в 'false' для асинхронного выполнения. При асинхронном выполнении выполнение завершается сразу после отправки запроса, не проверяя состояние тома. |
Примечания
Примечание
- Модули с префиксом na_ontap разработаны для поддержки платформы хранилища ONTAP.
Примеры
- name: Create FlexVol
na_ontap_volume:
state: present
name: ansibleVolume12
is_infinite: False
aggregate_name: ansible_aggr
size: 100
size_unit: mb
space_guarantee: none
tiering_policy: auto
policy: default
percent_snapshot_space: 60
qos_policy_group: max_performance_gold
vserver: ansibleVServer
wait_for_completion: True
space_slo: none
nvfail_enabled: False
comment: ansible created volume
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Volume Delete
na_ontap_volume:
state: absent
name: ansibleVolume12
aggregate_name: ansible_aggr
vserver: ansibleVServer
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Make FlexVol offline
na_ontap_volume:
state: present
name: ansibleVolume
is_infinite: False
is_online: False
vserver: ansibleVServer
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Create flexGroup volume manually
na_ontap_volume:
state: present
name: ansibleVolume
is_infinite: False
aggr_list: "{{ aggr_list }}"
aggr_list_multiplier: 2
size: 200
size_unit: mb
space_guarantee: none
policy: default
vserver: "{{ vserver }}"
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
https: False
unix_permissions: 777
snapshot_policy: default
time_out: 0
- name: Create flexGroup volume auto provision as flex group
na_ontap_volume:
state: present
name: ansibleVolume
is_infinite: False
auto_provision_as: flexgroup
size: 200
size_unit: mb
space_guarantee: none
policy: default
vserver: "{{ vserver }}"
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
https: False
unix_permissions: 777
snapshot_policy: default
time_out: 0
- name: Create FlexVol with QoS adaptive
na_ontap_volume:
state: present
name: ansibleVolume15
is_infinite: False
aggregate_name: ansible_aggr
size: 100
size_unit: gb
space_guarantee: none
policy: default
percent_snapshot_space: 10
qos_adaptive_policy_group: extreme
vserver: ansibleVServer
wait_for_completion: True
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Modify volume dr protection (vserver of the volume must be in a snapmirror relationship)
na_ontap_volume:
state: present
name: ansibleVolume
vserver_dr_protection: protected
vserver: "{{ vserver }}"
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
https: False
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Данный модуль поддерживается партнером Ansible. [сертифицировано]
Авторы
- Команда NetApp Ansible (@carchi8py) <ng-ansibleteam@netapp.com>
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/na_ontap_volume_module.html