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 boolean добавлено в 2.8 |
| Это расширенный параметр, значение по умолчанию - True. Если false, предотвращает обновление времени доступа к inode при чтении файла. Это значение полезно для объёмов с очень высоким трафиком чтения, так как предотвращает конфликт записи в файл inode объёма с чтением из других файлов. Этот параметр следует использовать с осторожностью. То есть, используйте этот параметр, если заранее известно, что корректное время доступа к inode для файлов на этом объёме не потребуется. |
| auto_provision_as - добавлено в 2.8 |
| Автоматически создавать объём FlexGroup. |
| efficiency_policy - добавлено в 2.7 | Позволяет установить политику эффективности хранения при создании объёма. | |
| encrypt boolean добавлено в 2.7 |
| Включить шифрование объёма. |
| from_name - добавлено в 2.7 | Имя существующего объёма, который будет переименован в name. | |
| hostname string / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port integer | Переопределить порт по умолчанию (80 или 443) на этот порт | |
| https boolean |
| Включить/выключить https |
| is_infinite boolean |
| Установить True, если объём - Бесконечный объём. Удаление бесконечного объёма асинхронно. |
| is_online boolean |
| Указанный объём онлайн или нет. |
| 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 - / обязательно | Имя объёма для управления. | |
| ontapi integer | Версия API ontap для использования | |
| password string / обязательно | Пароль для указанного пользователя. псевдонимы: pass | |
| percent_snapshot_space - | Процент пространства, резервируемого для снимков копий объёма. | |
| policy - | Имя политики экспорта. | |
| size - | Размер объёма в (size_unit). Требуется, когда state=present. | |
| size_unit - |
| Единица измерения, используемая для интерпретации параметра size. |
| snapdir_access boolean добавлено в 2.8 |
| Это расширенный параметр, значение по умолчанию - False. Включает видимую директорию '.snapshot', которая обычно присутствует в точках монтирования системы. Это значение также включает доступ ко всем другим директориям '.snapshot' в объёме. |
| snapshot_policy - добавлено в 2.8 | Имя политики снимков. Имя политики по умолчанию - 'default'. | |
| space_guarantee - |
| Стиль гарантии места для объёма. |
| state - |
| Должен ли указанный объём существовать или нет. |
| time_out - добавлено в 2.8 | По умолчанию: 180 | Время ожидания создания, изменения или удаления flexGroup в секундах. Возвращает ошибку, если задача не завершена в определённое время. Если 0, запрос асинхронный. По умолчанию 3 минуты. |
| type - | Тип объёма: чтение-запись (RW) или защита данных (DP). | |
| unix_permissions - добавлено в 2.8 | Биты разрешений Unix в восьмеричном или символьном формате. Например, 0 эквивалентно ------------, 777 эквивалентно ---rwxrwxrwx, оба формата принимаются. Допустимое восьмеричное значение от 0 до 777 включительно. | |
| username string / обязательно | Это может быть учётная запись на уровне кластера или SVM, в зависимости от того, нужен ли API на уровне кластера или SVM. Для получения дополнительной информации см. документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. псевдонимы: user |
| validate_certs boolean |
| Если установлено значение no, сертификаты SSL не будут проверяться.Это значение следует устанавливать только для False сайтов, используемых на собственных сайтах, которые используют самоподписанные сертификаты. |
| volume_security_style - |
| Стиль безопасности, связанный с этим томом. |
| vserver - / обязательно | Имя vserver для использования. | |
| wait_for_completion boolean добавлен в 2.8 |
| Установите этот параметр в 'true' для синхронного выполнения во время создания (дождитесь, пока состояние тома не станет онлайн) Установите этот параметр в '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
policy: default
percent_snapshot_space: 60
vserver: ansibleVServer
wait_for_completion: True
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
Статус
- Не гарантируется обратная совместимость данного модуля. [превью]
- Этот модуль поддерживается партнером 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.8/modules/na_ontap_volume_module.html