Модуль netapp_eseries.santricity.na_santricity_volume — управление томами хранилища NetApp E-Series (стандартными и тонкими)

allow_expansion

boolean

Разрешает увеличить размер тома в соответствии с требуемыми параметрами.

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

Варианты:

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

api_password

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

Пароль для аутентификации в SANtricity Web Services Proxy или Embedded Web Services API.

api_url

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

URL-адрес SANtricity Web Services Proxy или Embedded Web Services API.

Пример: https://prod-1.wahoo.acme.com:8443/devmgr/v2

api_username

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

Имя пользователя для аутентификации в SANtricity Web Services Proxy или Embedded Web Services API.

cache_without_batteries

boolean

Определяет, следует ли использовать кэширование без резервного питания от батареи.

Предупреждение: если cache_without_batteries==true, система хранения потеряет питание, а резервное питание от батареи отсутствует, данные будут потеряны!

Варианты:

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

data_assurance_enabled

boolean

Определяет, следует ли включить проверку целостности данных (DA) для тома.

Доступно только при создании нового тома в пуле хранения с дисками, поддерживающими функцию DA.

Варианты:

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

name

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

Имя тома, которым нужно управлять.

owning_controller

string

Указывает, какой контроллер будет основным владельцем тома.

Если значение не указано, контроллер самостоятельно выберет владельца.

Варианты:

• "A"
• "B"

read_ahead_enable

boolean

Определяет, включено ли автоматическое предварительное чтение из кэша.

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

Варианты:

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

read_cache_enable

boolean

Определяет, следует ли включить кэширование чтения для тома.

Варианты:

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

segment_size_kb

integer

Размер сегмента тома.

Все значения указаны в кибибайтах.

Часто используемые значения: 8, 16, 32, 64, 128, 256 и 512, однако доступные варианты зависят от системы.

Полный список значений для системы можно получить с помощью netapp_eseries.santricity.na_santricity_facts в разделе segment_sizes.

Для пула хранения raidDiskPool размер сегмента должен составлять 128 КБ.

В этом модуле изменение размера сегмента не поддерживается.

По умолчанию: 128

size

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

Требуется только при state==”present”.

Размер тома в единицах size_unit.

Для тонкого тома — размер виртуального тома в единицах size_unit.

Максимальный размер виртуального тома с тонким выделением составляет 256 ТБ; однако могут действовать и другие ограничения на уровне ОС.

size_tolerance_b

integer

Допуск для общего размера тома в байтах: если общий размер томов находится в пределах +/- size_tolerance_b, изменение размера не потребуется.

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

По умолчанию: 10485760

size_unit

string

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

Единица pct задаёт процент от общего доступного размера пула хранения.

Варианты:

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

ssd_cache_enabled

boolean

Следует ли включить существующий SSD-кэш для тома (операция завершится ошибкой, если SSD-кэш не настроен).

По умолчанию существующая настройка SSD-кэша игнорируется.

Варианты:

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

ssid

string

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

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

state

string

Определяет, должен ли указанный том существовать.

Варианты:

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

storage_pool_name

string

Требуется только, если запрошено state==”present”.

Имя пула хранения, в котором должен находиться том.

thin_provision

boolean

Определяет, следует ли использовать для тома тонкое выделение ресурсов.

Тонкие тома можно создавать только при raid_level==”raidDiskPool”.

Как правило, использовать тонкое выделение ресурсов не рекомендуется из-за влияния на производительность.

Варианты:

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

thin_volume_expansion_policy

string

Политика расширения тонкого тома.

Если thin_volume_expansion_policy==”automatic” и превышено значение thin_volume_growth_alert_threshold, размер репозитория thin_volume_max_repo_size будет автоматически увеличен.

Если thin_volume_expansion_policy==”manual” и превышено значение thin_volume_growth_alert_threshold, система хранения будет ожидать вмешательства оператора.

В этом модуле нельзя изменить политику расширения существующих тонких томов.

Как правило, почти всегда следует использовать thin_volume_expansion_policy==”automatic.

Варианты:

• "automatic" ← (по умолчанию)
• "manual"

thin_volume_growth_alert_threshold

integer

Порог использования репозитория с тонким выделением ресурсов (в процентах).

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

Значение должно быть в диапазоне от 10 до 99 включительно.

По умолчанию: 95

thin_volume_max_repo_size

float

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

Имеет значение только при thin_volume_expansion_policy==”automatic”.

Когда процент thin_volume_repo_size от thin_volume_max_repo_size превышает thin_volume_growth_alert_threshold, будет выдано предупреждение, и массив хранения выполнит политику thin_volume_expansion_policy.

При автоматическом расширении (thin_volume_expansion_policy==”automatic”) максимальный размер репозитория будет увеличен.

По умолчанию используется то же значение, что и для size.

thin_volume_repo_size

integer

Это значение (в единицах size_unit) задаёт объём пространства, выделяемого для репозитория с тонким выделением ресурсов.

Начальное значение должно быть от 4 ГБ до 256 ГБ включительно с шагом 4 ГБ.

При расширении размер увеличения должен быть от 4 ГБ до 256 ГБ включительно с шагом 4 ГБ.

Этот параметр не влияет на расширение при thin_volume_expansion_policy==”automatic”.

Как правило, почти всегда следует использовать thin_volume_expansion_policy==”automatic.

validate_certs

boolean

Следует ли проверять сертификаты HTTPS?

Варианты:

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

volume_metadata

dictionary

Словарь с метаданными самого тома.

Ключ словаря не может содержать более 14 символов.

Значения словаря не могут содержать более 240 символов.

wait_for_initialization

boolean

Заставляет модуль ожидать завершения операций расширения, прежде чем продолжить работу.

Варианты:

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

workload_metadata

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

dictionary

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

Если workload_name существует в массиве хранения, но метаданные отличаются, описание рабочей нагрузки будет обновлено. (Изменения затронут все связанные тома!)

При задании metadata необходимо указать workload_name.

Ключ словаря не может содержать более 16 символов.

Значения словаря не могут содержать более 60 символов.

workload_name

string

Метка рабочей нагрузки, описываемой метаданными.

Если указаны workload_name и metadata, определённая рабочая нагрузка будет добавлена в массив хранения.

Если workload_name существует в массиве хранения, но метаданные отличаются, описание рабочей нагрузки будет обновлено. (Изменения затронут все связанные тома!)

Существующие рабочие нагрузки можно получить с помощью netapp_eseries.santricity.na_santricity_facts.

write_cache_enable

boolean

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

Варианты:

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

write_cache_mirror_enable

boolean

Определяет, следует ли включить зеркалирование кэша записи.

Варианты:

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

msg

string

Состояние тома.

Возвращается: всегда

Пример: "Standard volume [workload_vol_1] has been created."