Модуль netapp.ontap.na_ontap_svm — SVM NetApp ONTAP
Примечание
Этот модуль входит в коллекцию netapp.ontap (версия 23.5.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: netapp.ontap.na_ontap_svm.
Добавлено в netapp.ontap 2.6.0
Краткое описание
- Создание, изменение или удаление SVM в NetApp ONTAP
Требования
На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.
- 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 или более поздняя версия.
Параметры
Параметр | Комментарии |
|---|---|
admin_state string добавлено в netapp.ontap 21.15.0 | При создании SVM она будет находиться в рабочем состоянии, если не указано иное. Игнорируется при использовании ZAPI. Варианты:
|
aggr_list list / elements=string | Список агрегатов, назначенных для операций с томами. Эти агрегаты могут совместно использоваться с другими Vserver. Если это поле указано при создании vserver, оно представляет список агрегатов, назначенных Vserver для операций с томами. При вызове vserver-get-iter это поле возвращает список Vserver, которым назначен хотя бы один из агрегатов, указанных в списке aggr. |
allowed_protocols list / elements=string | Это поле представляет список протоколов, разрешённых на Vserver. При изменении это поле должно включать существующий список и новые протоколы, чтобы избежать перебоев в работе данных. Несовместимо с Возможные значения nfs — протокол NFS, cifs — протокол CIFS, fcp — протокол FCP, iscsi — протокол iSCSI, ndmp — протокол NDMP, s3 — протокол S3, http — протокол HTTP (только ZAPI), nvme — протокол NVMe |
anti_ransomware_default_volume_state string добавлено в netapp.ontap 23.5.0 | Указывает состояние защиты от программ-вымогателей по умолчанию для томов в SVM. Если лицензия на защиту от программ-вымогателей отсутствует, это свойство игнорируется, а тома создаются в состоянии «отключено». Поддерживается только с REST, требуется ONTAP 9.10.1 или более поздняя версия. Варианты:
|
auto_enable_activity_tracking boolean добавлено в netapp.ontap 23.2.0 | Указывает, следует ли автоматически включать отслеживание активности томов для томов, создаваемых в SVM. Поддерживается только с REST, требуется ONTAP 9.12.1 или более поздняя версия. Варианты:
|
auto_enable_analytics boolean добавлено в netapp.ontap 23.2.0 | Указывает, следует ли автоматически включать аналитику файловой системы для томов, создаваемых в SVM. Поддерживается только с REST, требуется ONTAP 9.12.1 или более поздняя версия. Варианты:
|
cert_filepath string добавлено в netapp.ontap 20.6.0 | Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6. |
comment string добавлено в netapp.ontap 2.8.0 | Если это поле указано при создании vserver, оно содержит комментарий, связанный с Vserver. При вызове vserver-get-iter возвращается список соответствующих Vserver. |
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. |
from_name string добавлено в netapp.ontap 2.7.0 | Имя SVM, которое необходимо изменить |
hostname string / обязательный | Имя хоста или IP-адрес экземпляра ONTAP. |
http_port integer | Переопределяет порт по умолчанию (80 или 443) указанным портом. |
https boolean | Включает и отключает HTTPS. Игнорируется при использовании REST, поскольку поддерживается только HTTPS. Игнорируется при использовании аутентификации по SSL-сертификату, поскольку она требует SSL. Варианты:
|
ignore_rest_unsupported_options boolean добавлено в netapp.ontap 21.10.0 | Если значение равно true, игнорируются параметры Игнорируется, если для Варианты:
|
ipspace string добавлено в netapp.ontap 2.7.0 | Имя IPSpace Не может быть изменено после создания. |
key_filepath string добавлено в netapp.ontap 20.6.0 | Путь к файлу ключа клиента SSL. |
lambda_config dictionary добавлено в netapp.ontap 23.3.0 | Параметры конфигурации функции прокси-сервера AWS Lambda. Этот параметр и его подопции поддерживаются только с REST. |
|
aws_profile string |
Имя профиля AWS, используемого для аутентификации. |
|
aws_region string / обязательный |
Имя региона AWS. |
|
function_name string / обязательный |
Имя вызываемой функции AWS Lambda. |
language string добавлено в netapp.ontap 2.7.0 | Язык для SVM По умолчанию — C.UTF-8 Возможные значения языка 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 utf8mb4 Для большинства значений допускается суффикс .utf_8, например fr.utf_8 |
max_volumes string добавлено в netapp.ontap 21.12.0 | Максимальное количество томов, которые можно создать на vserver. Ожидается целое число или |
name псевдонимы: vserver string / обязательный | Имя управляемой SVM. vserver — удобный псевдоним при использовании module_defaults. |
ontapi integer | Версия API ONTAP, которую следует использовать |
password псевдонимы: pass string | Пароль указанного пользователя. |
root_volume string | Корневой том SVM. Не может быть изменён после создания. |
root_volume_aggregate string | Агрегат, на котором будет создан корневой том. Не может быть изменён после создания. |
root_volume_security_style string | Стиль безопасности корневого тома. Если это поле указано при создании vserver, оно задаёт стиль безопасности корневого тома Vserver. При вызове vserver-get-iter возвращается список соответствующих Vserver. Стиль безопасности ‘unified’, применяемый только к Infinite Volumes, нельзя использовать для корневого тома Vserver. Не может быть изменён после создания. Варианты:
|
services dictionary добавлено в netapp.ontap 21.10.0 | Включённые протоколы; доступно только с REST. При необходимости служба будет запущена. Может потребоваться действующая лицензия.
Если служба отсутствует, её состояние не изменяется. Несовместимо с |
|
cifs dictionary |
Служба протокола CIFS |
|
allowed boolean |
Если значение равно true, администратор SVM может управлять службой CIFS. Если значение равно false, службой может управлять только администратор кластера. Варианты:
|
|
fcp dictionary |
Служба протокола FCP |
|
allowed boolean |
Если значение равно true, администратор SVM может управлять службой FCP. Если значение равно false, службой может управлять только администратор кластера. Варианты:
|
|
enabled boolean |
Если служба разрешена, значение true включает службу FCP. Варианты:
|
|
iscsi dictionary |
Служба протокола iSCSI |
|
allowed boolean |
Если значение равно true, администратор SVM может управлять службой iSCSI. Если значение равно false, службой может управлять только администратор кластера. Варианты:
|
|
enabled boolean |
Если служба разрешена, значение true включает службу iSCSI. Варианты:
|
|
ndmp dictionary добавлено в netapp.ontap 21.24.0 |
Служба протокола Network Data Management Protocol |
|
allowed boolean |
Если задано значение true, администратор SVM может управлять службой NDMP. Если задано значение false, службой может управлять только администратор кластера. Требуется ONTAP 9.10.1 или более поздняя версия. Варианты:
|
|
nfs dictionary |
Служба протокола NFS |
|
allowed boolean |
Если значение равно true, администратор SVM может управлять службой NFS. Если значение равно false, службой может управлять только администратор кластера. Варианты:
|
|
enabled boolean |
Если служба разрешена, значение true включает службу NFS. Варианты:
|
|
nvme dictionary |
Служба протокола NVMe |
|
allowed boolean |
Если значение равно true, администратор SVM может управлять службой NVMe. Если значение равно false, службой может управлять только администратор кластера. Варианты:
|
|
enabled boolean |
Если служба разрешена, значение true включает службу NVMe. Варианты:
|
|
s3 dictionary |
Служба S3 |
|
allowed boolean |
Если значение равно true, администратор SVM может управлять службой S3. Если значение равно false, службой может управлять только администратор кластера. Требуется ONTAP 9.7.0 или более поздняя версия. Варианты:
|
snapshot_policy string добавлено в netapp.ontap 2.7.0 | Политика снимков по умолчанию для всех томов Vserver. Эта политика назначается всем томам, созданным в этом Vserver, если при создании тома явно не указана другая политика снимков или если позднее для тома не задана отдельная политика снимков. Политика снимков на уровне тома всегда имеет приоритет над политикой снимков по умолчанию для всего Vserver. |
state string | Указывает, должна ли указанная SVM существовать. Варианты:
|
storage_limit integer добавлено в netapp.ontap 23.1.0 | Указывает максимальный объем хранилища, разрешенный для одной SVM, в байтах. Для отключения контроля ограничения хранилища этому параметру можно присвоить значение zero. Поддерживается только при использовании REST, требуется ONTAP 9.13.1 или более поздняя версия. |
storage_limit_threshold_alert integer добавлено в netapp.ontap 23.2.0 | Указывает, при каком проценте емкости хранилища отправляется предупреждение. Значение по умолчанию — 90. Поддерживается только при использовании REST, требуется ONTAP 9.13.1 или более поздняя версия. |
subtype string добавлено в netapp.ontap 2.7.0 | Подтип создаваемого vserver. Не может быть изменен после создания. Варианты:
|
use_lambda boolean добавлено в netapp.ontap 23.2.0 | Указывает, следует ли использовать функцию прокси-сервера AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты:
|
use_rest string | Использовать REST или ZAPI. always — всегда использовать REST API, если модуль поддерживает REST. Если модуль не поддерживает REST, выдается предупреждение. Если параметр модуля не поддерживается в REST, выдается ошибка. never — всегда использовать ZAPI, если модуль поддерживает ZAPI. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка. auto — пытаться использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае используется 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 | Если задано значение Это следует задавать только как Варианты:
|
web dictionary | Конфигурация безопасности веб-служб. Для имени сертификата требуется ONTAP 9.8 или более поздняя версия. Для остальных параметров требуется ONTAP 9.10.1 или более поздняя версия. |
|
certificate string |
Имя сертификата, используемого интерфейсами управления кластером и узлами для запросов на TLS-подключение. Сертификат должен иметь тип «server». |
|
client_enabled boolean |
Включена ли аутентификация клиента. Варианты:
|
|
ocsp_enabled boolean |
Включена ли проверка с помощью протокола проверки статуса сертификатов в режиме онлайн. Варианты:
|
Примечания
Примечание
- При использовании REST поддерживается функция прокси-сервера AWS Lambda. Примеры см. в файле README.
- Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
- HTTPS включен по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, необходимо выполнить следующие команды ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’
Примеры
- name: Create SVM
netapp.ontap.na_ontap_svm:
state: present
name: ansibleVServer
root_volume: vol1
root_volume_aggregate: aggr1
root_volume_security_style: mixed
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Create SVM
netapp.ontap.na_ontap_svm:
state: present
services:
cifs:
allowed: true
fcp:
allowed: true
nfs:
allowed: true
enabled: true
s3:
allowed: true
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
https: true
validate_certs: false
- name: Stop SVM REST
netapp.ontap.na_ontap_svm:
state: present
name: ansibleVServer
admin_state: stopped
use_rest: always
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
Ссылки на коллекцию
© 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_svm_module.html