Модуль netapp.ontap.na_ontap_lun — управление LUN в NetApp ONTAP

cert_filepath

string

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

путь к файлу сертификата клиента SSL (.pem).

не поддерживается в Python 2.6.

comment

string

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

Необязательный описательный комментарий к LUN.

feature_flags

dictionary

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

Включить или отключить новую функцию.

Это можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость.

Поддерживаемые ключи и значения могут изменяться без предварительного уведомления. Неизвестные ключи игнорируются.

flexvol_name

псевдонимы: volume_name

string

Имя FlexVol, в котором должна находиться LUN.

Обязательно, если параметр san_application_template не указан.

Не допускается, если параметр san_application_template указан.

Не поддерживается в системе ASA r2.

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.

force_remove

boolean

Если задано значение «true», проверки, запрещающие уничтожение LUN, если она подключена к сети и сопоставлена, переопределяются.

Если задано значение «false», уничтожение подключенной к сети и сопоставленной LUN завершится ошибкой.

Допустимые значения:

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

force_remove_fenced

boolean

Если задано значение «true», проверки, запрещающие уничтожение ограждённой LUN, переопределяются.

Если задано значение «false», попытка уничтожить ограждённую LUN завершится ошибкой.

Если параметр не указан, по умолчанию используется значение «false». Это поле доступно в Data ONTAP 8.2 и более поздних версиях.

Не поддерживается с REST.

Допустимые значения:

• false
• true

force_resize

boolean

Принудительно уменьшить размер. Это необходимо для уменьшения размера LUN, чтобы избежать случайного уменьшения размера LUN.

Не поддерживается с REST.

Допустимые значения:

• false
• true

from_name

string

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

Имя LUN, которую требуется переименовать.

hostname

string / обязательный

Имя узла или IP-адрес экземпляра ONTAP.

http_port

integer

Переопределяет порт по умолчанию (80 или 443) указанным портом.

https

boolean

Включить или отключить https.

Игнорируется при использовании REST, поскольку поддерживается только https.

Игнорируется при использовании аутентификации с сертификатом SSL, так как для неё требуется SSL.

Допустимые значения:

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

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.

name

string / обязательный

Имя управляемой LUN.

Или имя группы LUN (имя тома), если используется san_application_template.

ontapi

integer

Версия API ONTAP, которую следует использовать.

os_type

псевдонимы: ostype

string

Тип ОС для LUN.

password

псевдонимы: pass

string

Пароль указанного пользователя.

provisioning_options

dictionary

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

Параметры, применяемые при создании.

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

auto

boolean

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

Если том существует, изменить его размер так, чтобы в нём поместилась новая LUN.

Поддерживается только в Unified ONTAP.

Допустимые значения:

• false
• true

count

integer

Количество LUN, подготавливаемых с этими свойствами.

Если указано это значение, имя считается префиксом, а к нему добавляется суффикс формата _<N>, где N — следующий доступный числовой индекс, начиная с 1.

qos_adaptive_policy_group

string

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

Группа адаптивных политик QoS, назначаемая LUN.

Определяет измеримые цели уровня обслуживания (SLO) и соглашения об уровне обслуживания (SLA), которые корректируются с учётом выделенного или используемого пространства LUN.

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

В REST qos_policy_group и qos_adaptive_policy_group обрабатываются как политика QOS.

qos_policy_group

string

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

Группа политик QoS, назначаемая LUN.

В REST qos_policy_group и qos_adaptive_policy_group обрабатываются как политика QOS.

qtree_name

string

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

Имя Qtree, содержащего новую LUN.

Не допускается, если параметр san_application_template указан.

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

Qtree не поддерживаются в системе ASA r2.

san_application_template

dictionary

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

Дополнительные параметры при использовании REST API application/applications для создания LUN.

По умолчанию модуль использует ZAPI и переключается на REST, если указан san_application_template.

Создать одну или несколько LUN (и при необходимости связанный том).

Поддерживаются операции на уровне LUN; для их выполнения необходимо знать короткое имя LUN.

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

Модуль частично поддерживает ONTAP 9.7 для операций создания и удаления, но не для изменения (ограничения API).

Не поддерживается в системе ASA r2.

exclude_aggregates

list / элементы=string

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

Список имён агрегатов, которые следует исключить при создании тома.

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

igroup_name

string

Имя группы инициаторов, через которую будет осуществляться доступ к содержимому этого приложения.

lun_count

integer

Количество LUN в компоненте приложения (от 1 до 32).

name

string / обязательный

Имя приложения SAN.

protection_type

dictionary

Политика снимков для тома, на котором размещены LUN.

local_policy

string

Политика копирования снимков для тома.

scope

string

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

Указывает, обозначает ли имя верхнего уровня отдельную LUN или группу LUN (приложение).

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

Чтобы преобразовать существующий том в интеллектуальный контейнер, необходимо задать для scope значение ‘application’.

Модуль сообщает об ошибке, если используется ‘lun’ или ‘application’, а требуемое действие выполнить невозможно.

Модуль выдаёт предупреждения, если используется значение ‘auto’ по умолчанию и требуемые действия неоднозначны.

Допустимые значения:

• "application"
• "auto" ← (по умолчанию)
• "lun"

storage_service

string

Уровень производительности службы (PSL) для этого тома.

Допустимые значения:

• "value"
• "performance"
• "extreme"

tiering

dictionary

Политика размещения данных в облачных уровнях хранения.

control

string

Правила размещения контейнера на уровнях хранения.

Допустимые значения:

• "required"
• "best_effort"
• "disallowed"

object_stores

list / элементы=string

Список имён объектных хранилищ для размещения данных на уровнях хранения.

policy

string

Политика размещения данных в облачных уровнях хранения.

Допустимые значения:

• "all"
• "auto"
• "none"
• "snapshot-only"

total_size

integer

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

Общий размер компонента приложения, распределённый между входящими в него LUN в total_size_unit.

Рекомендуется, если указан lun_count.

Обязательно, если указан lun_count и его значение больше 1.

Примечание. Если lun_count равно 1 и total_size не указан, для обратной совместимости используется size.

total_size_unit

string

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

Единица измерения, используемая для интерпретации параметра total_size.

Если параметр не указан, используется size_unit.

Допустимые значения:

• "bytes"
• "b"
• "kb"
• "mb"
• "gb"
• "tb"
• "pb"
• "eb"
• "zb"
• "yb"

use_san_application

boolean

Использовать ли REST API application/applications для создания LUN.

По умолчанию устанавливается значение true, если указан любой другой подпараметр.

Допустимые значения:

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

size

integer

Размер LUN в size_unit.

Обязательно при создании одной LUN, если шаблон приложения не используется.

size_unit

string

Единица измерения, используемая для интерпретации параметра size.

Допустимые значения:

• "bytes"
• "b"
• "kb"
• "mb"
• "gb" ← (по умолчанию)
• "tb"
• "pb"
• "eb"
• "zb"
• "yb"

space_allocation

boolean

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

Включает поддержку функций SCSI Thin Provisioning. Не включайте этот параметр, если хост и файловая система их не поддерживают.

Не поддерживается в системе ASA r2. Для всех LUN включена подготовка SCSI с тонким выделением ресурсов.

Допустимые значения:

• false
• true

space_reserve

boolean

Можно задать значение «false», чтобы создать LUN без резервирования пространства.

Не поддерживается в системе ASA r2. Все LUN подготавливаются без резервирования пространства.

Допустимые значения:

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

state

string

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

Допустимые значения:

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

use_exact_size

boolean

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

Если задать значение «false», размер LUN будет округлён для значений >= 450g.

Допустимые значения:

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

use_lambda

логическое значение

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

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

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

Варианты:

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

use_rest

строка

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

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

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

auto — пытаться использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае использовать ZAPI.

По умолчанию: "always"

username

псевдонимы: user

строка

Это может быть учетная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или уровня SVM.

Дополнительную информацию см. в документации https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html.

Поддерживаются два метода аутентификации

1. Базовая аутентификация с использованием имени пользователя и пароля.
2. Аутентификация по SSL-сертификату с использованием файла сертификата SSL-клиента и, при необходимости, файла закрытого ключа.

Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена.

validate_certs

логическое значение

Если задано значение no, проверка SSL-сертификатов выполняться не будет.

Это следует задавать только для False на сайтах под личным управлением, использующих самозаверяющие сертификаты.

Варианты:

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

vserver

строка / обязательный

Имя используемого vserver.