Spec-Zone.ru › Ansible

Модуль 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.

Варианты:

  • "running"
  • "stopped"

aggr_list

list / elements=string

Список агрегатов, назначенных для операций с томами.

Эти агрегаты могут совместно использоваться с другими Vserver.

Если это поле указано при создании vserver, оно представляет список агрегатов, назначенных Vserver для операций с томами.

При вызове vserver-get-iter это поле возвращает список Vserver, которым назначен хотя бы один из агрегатов, указанных в списке aggr.

allowed_protocols

list / elements=string

Это поле представляет список протоколов, разрешённых на Vserver.

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

Несовместимо с services.

Возможные значения

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 или более поздняя версия.

Варианты:

  • "disabled"
  • "dry_run"

auto_enable_activity_tracking

boolean

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

Указывает, следует ли автоматически включать отслеживание активности томов для томов, создаваемых в SVM.

Поддерживается только с REST, требуется ONTAP 9.12.1 или более поздняя версия.

Варианты:

  • false
  • true

auto_enable_analytics

boolean

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

Указывает, следует ли автоматически включать аналитику файловой системы для томов, создаваемых в SVM.

Поддерживается только с REST, требуется ONTAP 9.12.1 или более поздняя версия.

Варианты:

  • false
  • true

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, где каждый элемент — целое число.

Если для use_rest задано значение auto, в зависимости от версии и возможностей платформы может быть принудительно выполнен переход на ZAPI.

Игнорируется при использовании 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.

Варианты:

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

ignore_rest_unsupported_options

boolean

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

Если значение равно true, игнорируются параметры root_volume, root_volume_aggregate, root_volume_security_style, если целевая система поддерживает REST.

Игнорируется, если для use_rest задано значение never.

Варианты:

  • false ← (по умолчанию)
  • 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.

Ожидается целое число или unlimited.

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.

Не может быть изменён после создания.

Варианты:

  • "unix"
  • "ntfs"
  • "mixed"
  • "unified"

services

dictionary

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

Включённые протоколы; доступно только с REST.

При необходимости служба будет запущена. Может потребоваться действующая лицензия.

enabled не поддерживается для CIFS; чтобы включить его, используйте na_ontap_cifs_server.

enabled не поддерживается для s3; чтобы включить его, используйте na_ontap_s3_services.

Если служба отсутствует, её состояние не изменяется.

Несовместимо с allowed_protocols.

cifs

dictionary

Служба протокола CIFS

allowed

boolean

Если значение равно true, администратор SVM может управлять службой CIFS. Если значение равно false, службой может управлять только администратор кластера.

Варианты:

  • false
  • true

fcp

dictionary

Служба протокола FCP

allowed

boolean

Если значение равно true, администратор SVM может управлять службой FCP. Если значение равно false, службой может управлять только администратор кластера.

Варианты:

  • false
  • true

enabled

boolean

Если служба разрешена, значение true включает службу FCP.

Варианты:

  • false
  • true

iscsi

dictionary

Служба протокола iSCSI

allowed

boolean

Если значение равно true, администратор SVM может управлять службой iSCSI. Если значение равно false, службой может управлять только администратор кластера.

Варианты:

  • false
  • true

enabled

boolean

Если служба разрешена, значение true включает службу iSCSI.

Варианты:

  • false
  • true

ndmp

dictionary

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

Служба протокола Network Data Management Protocol

allowed

boolean

Если задано значение true, администратор SVM может управлять службой NDMP.

Если задано значение false, службой может управлять только администратор кластера.

Требуется ONTAP 9.10.1 или более поздняя версия.

Варианты:

  • false
  • true

nfs

dictionary

Служба протокола NFS

allowed

boolean

Если значение равно true, администратор SVM может управлять службой NFS. Если значение равно false, службой может управлять только администратор кластера.

Варианты:

  • false
  • true

enabled

boolean

Если служба разрешена, значение true включает службу NFS.

Варианты:

  • false
  • true

nvme

dictionary

Служба протокола NVMe

allowed

boolean

Если значение равно true, администратор SVM может управлять службой NVMe. Если значение равно false, службой может управлять только администратор кластера.

Варианты:

  • false
  • true

enabled

boolean

Если служба разрешена, значение true включает службу NVMe.

Варианты:

  • false
  • true

s3

dictionary

Служба S3

allowed

boolean

Если значение равно true, администратор SVM может управлять службой S3. Если значение равно false, службой может управлять только администратор кластера.

Требуется ONTAP 9.7.0 или более поздняя версия.

Варианты:

  • false
  • true

snapshot_policy

string

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

Политика снимков по умолчанию для всех томов Vserver. Эта политика назначается всем томам, созданным в этом Vserver, если при создании тома явно не указана другая политика снимков или если позднее для тома не задана отдельная политика снимков. Политика снимков на уровне тома всегда имеет приоритет над политикой снимков по умолчанию для всего Vserver.

state

string

Указывает, должна ли указанная SVM существовать.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

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.

Не может быть изменен после создания.

Варианты:

  • "default"
  • "dp_destination"
  • "sync_source"
  • "sync_destination"

use_lambda

boolean

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

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

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

Варианты:

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

use_rest

string

Использовать REST или ZAPI.

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

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

auto — пытаться использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае используется 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 ← (по умолчанию)

web

dictionary

Конфигурация безопасности веб-служб.

Для имени сертификата требуется ONTAP 9.8 или более поздняя версия.

Для остальных параметров требуется ONTAP 9.10.1 или более поздняя версия.

certificate

string

Имя сертификата, используемого интерфейсами управления кластером и узлами для запросов на TLS-подключение.

Сертификат должен иметь тип «server».

client_enabled

boolean

Включена ли аутентификация клиента.

Варианты:

  • false
  • true

ocsp_enabled

boolean

Включена ли проверка с помощью протокола проверки статуса сертификатов в режиме онлайн.

Варианты:

  • false
  • true

Примечания

Примечание

  • При использовании 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 }}"

Авторы

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

Spec-Zone.ru

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