Модуль hitachivantara.vspone_block.vsp.hv_ldev_bulk — управление несколькими логическими устройствами (LDEV) в пакетном режиме в системах хранения данных VSP Block.

connection_info

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

Информация, необходимая для установления соединения с системой хранения данных.

address

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

IP-адрес или имя хоста системы хранения данных.

api_token

string

Токен для работы с заблокированными ресурсами.

connection_type

string

Тип подключения к системе хранения данных.

Варианты:

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

password

string

Пароль для аутентификации. Это обязательное поле.

username

string

Имя пользователя для аутентификации. Это обязательное поле.

spec

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

Спецификация для массовых операций с LDEV. Поддерживает создание, изменение или удаление нескольких LDEV.

capacity_saving

string

Включить ли функции экономии емкости для всех LDEV в массовой операции. Допустимы следующие три значения: - 1. compression — включить функцию экономии емкости (сжатие). - 2. compression_deduplication — включить функцию экономии емкости (сжатие и дедупликация). - 3 disabled — отключить функцию экономии емкости (сжатие и дедупликация). Значение по умолчанию — disabled. Этот параметр будет применен ко всем LDEV, созданным в рамках массовой операции. Необязателен для массового создания нескольких LDEV в диапазоне идентификаторов LDEV с использованием параллельного выполнения. Обязателен для массового создания нескольких LDEV с экономией емкости и data_reduction_share.

clpr_id

integer

Идентификатор CLPR (Control Logical Partition), которому будут назначены все LDEV. Используется для указания CLPR для нескольких LDEV. Если параметр не указан, LDEV будут назначены CLPR по умолчанию. Этот параметр будет применен ко всем LDEV в рамках массовой операции. Обязателен для массового назначения идентификатора CLPR нескольким томам.

cylinder

integer

Номер цилиндра для мэйнфреймных LDEV. Используется для указания цилиндра для нескольких LDEV. Этот параметр будет применен ко всем мэйнфреймным LDEV в рамках массовой операции.

data_reduction_process_mode

string

Режим обработки сокращения объема данных для функции экономии емкости всех LDEV. Этот параметр будет применен ко всем LDEV в рамках массовой операции. Допустимые значения: - “post_process” — режим постобработки. - “inline” — встроенный режим. Необязателен для массового изменения параметров нескольких томов.

Варианты:

• "post_process"
• "inline"

data_reduction_share

boolean

Указать, следует ли создавать общие тома с сокращением объема данных для всех LDEV в рамках массовой операции. Для Thin Image Advance это значение устанавливается в true. Этот параметр будет применен ко всем LDEV, созданным в рамках массовой операции. Обязателен для массового создания нескольких LDEV с экономией емкости и data_reduction_share.

Варианты:

• false
• true

emulation_type

string

Тип эмуляции для мэйнфреймных LDEV. Используется для указания типа эмуляции нескольких LDEV. Этот параметр будет применен ко всем мэйнфреймным LDEV в рамках массовой операции. Примеры значений: 3390-A и 3390-V.

end_ldev_id

string

Конечный идентификатор LDEV в диапазоне LDEV, создаваемых массово. Используется для указания конца диапазона идентификаторов LDEV при массовом создании. Будут созданы все LDEV от start_ldev_id до end_ldev_id. Значение может быть десятичным или шестнадцатеричным. Обязателен для массового создания нескольких LDEV в диапазоне идентификаторов LDEV с использованием параллельного выполнения.

external_parity_group

string

Идентификатор внешней группы четности, которой будут назначены LDEV. Используется для указания внешней группы четности для нескольких LDEV в массовых операциях. Если параметр не указан, LDEV будут назначены группе четности по умолчанию. Необязателен для массового создания нескольких LDEV с использованием внешней группы четности и автоматического выбора свободных идентификаторов LDEV.

force

boolean

Принудительное удаление нескольких LDEV. Удаляет LDEV и исключает их из групп хостов, целей iSCSI или пространства имен подсистемы NVM. При использовании в массовых операциях применяется ко всем указанным LDEV в списке ldev_ids. Обязателен для принудительного массового удаления нескольких LDEV с исключением их из групп хостов, целей iSCSI или пространства имен подсистемы NVM.

Варианты:

• false
• true

format_type

string

Тип форматирования нескольких томов. Допустимые значения: - “quick” — быстрое форматирование. - “normal” — обычное форматирование. Форматирование всех томов может занять некоторое время. Этот тип форматирования будет применен ко всем LDEV в рамках массовой операции. Необязателен для массового форматирования нескольких томов.

Варианты:

• "quick" ← (по умолчанию)
• "normal"

host_nqns

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

Список NQN хостов для добавления к нескольким LDEV или удаления из них в зависимости от значения state. При использовании в массовых операциях эти NQN будут применены ко всем указанным LDEV. Необязателен для массовых операций с подсистемами NVM.

is_alua_enabled

boolean

Включен ли ALUA (Asymmetric Logical Unit Access) для всех LDEV. Этот параметр будет применен ко всем LDEV в рамках массовой операции. Необязателен для массового изменения параметров нескольких томов.

Варианты:

• false
• true

is_compression_acceleration_enabled

boolean

Включено ли ускорение сжатия функции экономии емкости для всех LDEV. Этот параметр будет применен ко всем LDEV в рамках массовой операции. Необязателен для массового создания нескольких LDEV в диапазоне идентификаторов LDEV с использованием параллельного выполнения / массового изменения параметров нескольких томов.

Варианты:

• false
• true

is_ese_volume

boolean

Являются ли LDEV томами ESE (Enhanced Space Efficiency). Используется для указания, являются ли несколько LDEV томами ESE. Этот параметр будет применен ко всем LDEV в рамках массовой операции.

Варианты:

• false
• true

is_full_allocation_enabled

boolean

Являются ли LDEV томами с полным выделением емкости. Этот параметр будет применен ко всем LDEV в рамках массовой операции. Необязателен для массового изменения параметров нескольких томов.

Варианты:

• false
• true

is_parallel_execution_enabled

boolean

Включить ли параллельное выполнение массовых операций с LDEV. Это значительно ускоряет массовые операции. Если установлено значение true, операции с несколькими LDEV будут выполняться параллельно. Настоятельно рекомендуется при работе с большим количеством LDEV. Обязателен для массового создания нескольких LDEV в диапазоне идентификаторов LDEV с использованием параллельного выполнения.

Варианты:

• false
• true

is_relocation_enabled

boolean

Указать, следует ли включить параметр перемещения уровней для нескольких томов HDT. Этот параметр будет применен ко всем LDEV в рамках массовой операции. Необязателен для массового изменения параметров нескольких томов / массового создания нескольких новых томов с политикой многоуровневого хранения.

Варианты:

• false
• true

is_tse_volume

boolean

Являются ли LDEV томами TSE (Thin Provisioning with Space Efficiency). Используется для указания, являются ли несколько LDEV томами TSE. Этот параметр будет применен ко всем LDEV в рамках массовой операции.

Варианты:

• false
• true

ldev_ids

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

Список идентификаторов LDEV для массовых операций. Укажите несколько идентификаторов LDEV, чтобы одновременно выполнить над ними операции. Используйте этот параметр для массового удаления, обновления, форматирования или других массовых операций с существующими LDEV. Пример: [100, 101, 102, 103, 104].

mp_blade_id

integer

Идентификатор MP blade, которому будут назначены все LDEV. Используется для указания MP blade для нескольких LDEV. Если параметр не указан, LDEV будут назначены MP blade по умолчанию. Этот параметр будет применен ко всем LDEV в рамках массовой операции. Необязателен для массового назначения идентификатора MP blade нескольким томам.

name

string

Имя одного LDEV (необязательно). Для массовых операций используйте параметр ‘names’. Если параметр указан, имя LDEV будет иметь вид ‘name-<ldev_id>’. Если параметр не указан и ‘names’ не задан, LDEV будут присвоены имена по умолчанию в формате “name-<ldev_id>”, если указаны start_ldev_id и end_ldev_id, иначе — “smrha-<ldev_id>”. Это соглашение об именовании применяется как при создании одного LDEV, так и при массовом создании.

names

dictionary

Конфигурация имен для нескольких LDEV в массовых операциях. Используется для автоматического создания последовательных имен нескольких LDEV. Пример: base_name=”vol”, start_number=1, number_of_digits=3 создает vol001, vol002, vol003 и т. д.

base_name

string

Префикс базового имени для LDEV в массовой операции. Фактическое имя каждого LDEV будет создано добавлением к этому базовому имени последовательного номера. Пример: base_name=”prod_vol” создает prod_vol001, prod_vol002 и т. д.

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

number_of_digits

integer

Количество цифр в последовательном номере, включаемом в создаваемые имена LDEV. Используется для дополнения числа нулями слева. Пример: number_of_digits=4 создает 0001, 0002, 0003 и т. д. Используется вместе с base_name для создания имен нескольких LDEV.

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

start_number

integer

Начальный номер для создания последовательных имен LDEV в массовых операциях. Используется вместе с base_name для создания имен нескольких LDEV. Пример: start_number=5 с base_name=”vol” создает vol005, vol006 и т. д.

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

number_of_ldevs

integer

Количество LDEV, создаваемых в рамках массовой операции. Система автоматически назначит свободные идентификаторы LDEV указанному количеству LDEV. Используйте этот параметр, если нужно создать определенное количество LDEV без указания точных идентификаторов LDEV. Пример: number_of_ldevs=10 создаст 10 новых LDEV.

nvm_subsystem_name

string

Укажите имя подсистемы NVM, в которой будут представлены LDEV. Можно использовать для массового представления нескольких LDEV в подсистеме NVM. Необязателен для массовых операций с подсистемами NVM.

parity_group_id

string

Идентификатор parity_group, в которой будут созданы LDEV. Параметры pool_id и parity_group_id являются взаимоисключающими. Обязателен для массового создания нескольких LDEV с использованием группы четности и автоматического выбора свободных идентификаторов LDEV.

pool_id

integer

Идентификатор пула, в котором будут созданы LDEV. Параметры pool_id и parity_group_id являются взаимоисключающими. Обязателен для массового создания нескольких LDEV в пуле / создания нескольких LDEV в диапазоне идентификаторов LDEV с использованием параллельного выполнения / создания нескольких LDEV с экономией емкости и data_reduction_share / настройки QoS для нескольких томов / создания нескольких томов с политикой многоуровневого хранения / создания нескольких томов с назначением виртуальных LDEV.

qos_settings

dictionary

Параметры QoS, применяемые к нескольким LDEV в рамках массовой операции. Эти параметры будут применены ко всем LDEV, указанным в ldev_ids, или ко всем вновь созданным LDEV. Обязателен для массовой настройки QoS нескольких существующих томов / массовой настройки QoS нескольких новых томов.

lower_alert_allowable_time

integer

Нижнее допустимое время для предупреждения, применяемое ко всем LDEV в рамках массовой операции. Необязательно для массовой настройки QoS нескольких существующих или новых томов.

lower_iops

integer

Нижний предел IOPS, применяемый ко всем LDEV в рамках массовой операции. Необязательно для массовой настройки QoS нескольких существующих или новых томов.

lower_transfer_rate

integer

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

response_alert_allowable_time

integer

Допустимое время отклика для предупреждения, применяемое ко всем LDEV в рамках массовой операции. Необязательно для массовой настройки QoS нескольких существующих или новых томов.

response_priority

integer

Приоритет отклика, применяемый ко всем LDEV в рамках массовой операции. Необязательно для массовой настройки QoS нескольких существующих или новых томов.

upper_alert_allowable_time

integer

Верхнее допустимое время для предупреждения, применяемое ко всем LDEV в рамках массовой операции. Необязательно для массовой настройки QoS нескольких существующих или новых томов.

upper_iops

integer

Верхний предел IOPS, применяемый ко всем LDEV в рамках массовой операции. Необязательно для массовой настройки QoS нескольких существующих или новых томов.

upper_transfer_rate

integer

Верхний предел скорости передачи данных, применяемый ко всем LDEV в рамках массовой операции. Необязательно для массовой настройки QoS нескольких существующих или новых томов.

resource_group_id

integer

Идентификатор группы ресурсов для нескольких LDEV. Используется для указания группы ресурсов для нескольких LDEV. Этот параметр будет применен ко всем LDEV в рамках массовой операции.

should_format_volume

boolean

Следует ли форматировать несколько томов после создания или уже существующие тома. Если задано значение true, будут отформатированы все LDEV, указанные в ldev_ids. Обязательный параметр для пакетного форматирования нескольких томов.

Варианты:

• false
• true

should_reclaim_zero_pages

boolean

Следует ли освободить нулевые страницы нескольких томов DP. Эта операция используется для освобождения пространства в нескольких томах DP. Если задано значение true, нулевые страницы будут освобождены во всех указанных томах DP. Обязательный параметр для пакетного освобождения нулевых страниц нескольких томов DP.

Варианты:

• false
• true

should_shred_volume_enable

boolean

Выполняет очистку нескольких LDEV (обычных томов) или томов DP. Каждый том трижды перезаписывается фиктивными данными. При использовании пакетных операций это действие применяется ко всем LDEV в списке ldev_ids. Обязательный параметр для пакетной очистки нескольких существующих томов / пакетной очистки нескольких существующих томов перед удалением.

Варианты:

• false
• true

should_stop_all_volume_format

boolean

Следует ли остановить все текущие операции форматирования нескольких томов. Этот параметр используется для остановки выполняющихся задач форматирования томов для нескольких LDEV. Если задано значение true, будут остановлены все операции форматирования томов. Необязательный параметр для пакетной остановки всех операций форматирования томов.

Варианты:

• false
• true

size

string

Размер каждого LDEV. Можно указать в таких единицах, как GB, TB или MB (например, ‘10GB’, ‘5TB’, ‘100MB’, 200). Этот размер будет применен ко всем LDEV, созданным в рамках пакетной операции. Обязательный параметр для пакетного создания нескольких LDEV в диапазоне идентификаторов LDEV с использованием параллельного выполнения / увеличения размера нескольких LDEV / создания нескольких LDEV с использованием группы четности и автоматического выбора свободного идентификатора LDEV / создания нескольких LDEV с использованием внешней группы четности и автоматического выбора свободного идентификатора LDEV / создания нескольких LDEV с экономией емкости и data_reduction_share / настройки параметров QoS для нескольких новых томов / создания нескольких новых томов с политикой распределения по уровням.

ssid

string

SSID (идентификатор подсистемы) для мэйнфреймовых LDEV. Используется для указания SSID нескольких LDEV. Если параметр не задан, для всех LDEV будет использоваться SSID по умолчанию. Если он задан, будет использоваться указанный SSID. Этот параметр применяется ко всем мэйнфреймовым LDEV в рамках пакетной операции.

start_ldev_id

string

Начальный идентификатор LDEV для диапазона LDEV, создаваемых пакетом. Используется для определения начала диапазона идентификаторов LDEV при пакетном создании. Если параметр не задан, будет назначен свободный идентификатор LDEV. Можно указать в десятичном или шестнадцатеричном формате. Обязательный параметр для пакетного создания нескольких LDEV в диапазоне идентификаторов LDEV с использованием параллельного выполнения.

state

string

Состояние задачи подсистем NVM для пакетных операций. Применяется только при указании nvm_subsystem_name.

add_host_nqn — добавление NQN узла к нескольким LDEV.

remove_host_nqn — удаление NQN узла из нескольких LDEV.

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

Варианты:

• "add_host_nqn" ← (по умолчанию)
• "remove_host_nqn"

tier_level_for_new_page_allocation

string

Укажите, какой уровень пула HDT будет иметь приоритет при выделении новой страницы для нескольких томов. Этот параметр применяется ко всем LDEV в рамках пакетной операции. Необязательный параметр для пакетного создания нескольких новых томов с политикой распределения по уровням.

tiering_policy

dictionary

Политика распределения по уровням, применяемая к нескольким LDEV в рамках пакетной операции. Этот параметр применяется ко всем LDEV в рамках пакетной операции. Необязательный параметр для пакетного создания нескольких новых томов с политикой распределения по уровням.

tier1_allocation_rate_max

integer

Максимальное значение для уровня 1 — число от 1 до 100. Применяется ко всем LDEV в рамках пакетной операции. Необязательный параметр для пакетного создания нескольких новых томов с политикой распределения по уровням.

tier1_allocation_rate_min

integer

Минимальное значение для уровня 1 — число от 1 до 100. Применяется ко всем LDEV в рамках пакетной операции. Необязательный параметр для пакетного создания нескольких новых томов с политикой распределения по уровням.

tier3_allocation_rate_max

integer

Максимальное значение для уровня 3 — число от 1 до 100. Применяется ко всем LDEV в рамках пакетной операции. Необязательный параметр для пакетного создания нескольких новых томов с политикой распределения по уровням.

tier3_allocation_rate_min

integer

Минимальное значение для уровня 3 — число от 1 до 100. Применяется ко всем LDEV в рамках пакетной операции. Необязательный параметр для пакетного создания нескольких новых томов с политикой распределения по уровням.

tier_level

integer

Уровень распределения — число от 0 до 31. Применяется ко всем LDEV в рамках пакетной операции. Необязательный параметр для пакетного создания нескольких новых томов с политикой распределения по уровням.

vldev_ids

list / elements=integer

Список идентификаторов виртуальных LDEV для пакетного назначения виртуальных LDEV. Используется для пакетного назначения виртуальных LDEV нескольким LDEV. Необходимо использовать вместе с ldev_ids и state=’assign_virtual_ldev’.

state

string

Требуемое состояние для пакетных операций с LDEV.

Варианты:

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

storage_system_info

dictionary

Сведения о системе хранения данных. Это необязательное поле.

serial

string

Серийный номер системы хранения данных.

check_mode

Поддержка: нет

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

volumes

list / elements=dictionary

Том хранилища с его атрибутами.

Возвращается: при успехе

canonical_name

string

Уникальный идентификатор тома.

Возвращается: при успехе

Пример: "naa.60060e8028273d005080273d00000102"

clpr_id

integer

Идентификатор CLPR (логического раздела управления).

Возвращается: при успехе

Пример: 0

compression_acceleration_status

string

Состояние ускорителя сжатия.

Возвращается: при успехе

Пример: "ENABLED"

cylinder

integer

Номер цилиндра тома мейнфрейма.

Возвращается: при успехе

Пример: 65945

data_reduction_process_mode

string

Режим обработки сокращения объёма данных.

Возвращается: при успехе

Пример: "inline"

dedup_compression_progress

integer

Процент выполнения дедупликации и сжатия.

Возвращается: при успехе

Пример: -1

dedup_compression_status

string

Состояние дедупликации и сжатия.

Возвращается: при успехе

Пример: "ENABLED"

deduplication_compression_mode

string

Режим дедупликации и сжатия.

Возвращается: при успехе

Пример: "compression_deduplication"

emulation_type

string

Тип эмуляции тома.

Возвращается: при успехе

Пример: "3390-V-CVS"

hostgroups

list / elements=dictionary

Список групп хостов, связанных с томом.

Возвращается: при успехе

Пример: []

is_alua

boolean

Указывает, включён ли ALUA.

Возвращается: при успехе

Пример: false

is_command_device

boolean

Указывает, является ли том командным устройством.

Возвращается: при успехе

is_compression_acceleration_enabled

boolean

Указывает, включён ли ускоритель сжатия.

Возвращается: при успехе

Пример: true

is_data_reduction_share_enabled

boolean

Указывает, включён ли общий доступ к сокращению объёма данных.

Возвращается: при успехе

Пример: true

is_device_group_definition_enabled

boolean

Указывает, включено ли определение группы устройств.

Возвращается: при успехе

is_encryption_enabled

boolean

Указывает, включено ли шифрование.

Возвращается: при успехе

Пример: false

is_full_allocation_enabled

boolean

Указывает, включено ли полное выделение пространства.

Возвращается: при успехе

Пример: false

is_relocation_enabled

boolean

Указывает, включено ли перемещение между уровнями хранения.

Возвращается: при успехе

is_security_enabled

boolean

Указывает, включена ли безопасность.

Возвращается: при успехе

is_user_authentication_enabled

boolean

Указывает, включена ли аутентификация пользователей.

Возвращается: при успехе

is_write_protected

boolean

Указывает, включена ли защита от записи.

Возвращается: при успехе

is_write_protected_by_key

boolean

Указывает, включена ли защита от записи с помощью ключа.

Возвращается: при успехе

iscsi_targets

list / elements=dictionary

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

Возвращается: при успехе

Пример: []

ldev_id

integer

Идентификатор логического устройства.

Возвращается: при успехе

Пример: 10010

ldev_id_hex

string

Идентификатор логического устройства в шестнадцатеричном формате.

Возвращается: при успехе

Пример: "00:27:1A"

mp_blade_id

integer

Идентификатор лезвия MP.

Возвращается: при успехе

Пример: 3

name

string

Имя тома.

Возвращается: при успехе

Пример: "smrha-258"

num_of_ports

integer

Количество портов, связанных с томом.

Возвращается: при успехе

Пример: 2

nvm_subsystems

list / elements=dictionary

Список подсистем NVMe, связанных с томом.

Возвращается: при успехе

Пример: []

parent_volume_id

integer

Идентификатор родительского тома для томов снимков.

Возвращается: при успехе

Пример: -1

parent_volume_id_hex

string

Идентификатор родительского тома в шестнадцатеричном формате.

Возвращается: при успехе

Пример: "-0:00:01"

parity_group_id

string

Идентификатор группы чётности.

Возвращается: при успехе

Пример: "1-8"

path_count

integer

Количество путей к тому.

Возвращается: при успехе

Пример: 2

pool_id

integer

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

Возвращается: при успехе

Пример: 13

ports

list / elements=dictionary

Список портов, связанных с томом.

Возвращается: при успехе

Пример: [{"host_group_name": "1C-G00", "host_group_number": 156, "lun": 26, "port_id": "CL1-C"}]

host_group_name

string

Имя группы хостов.

Возвращается: при успехе

Пример: "1C-G00"

host_group_number

integer

Номер группы хостов.

Возвращается: при успехе

Пример: 156

lun

integer

Номер логического устройства.

Возвращается: при успехе

Пример: 26

port_id

string

Идентификатор порта.

Возвращается: при успехе

Пример: "CL1-C"

provision_type

string

Тип выделения ресурсов для тома.

Возвращается: при успехе

Пример: "CVS"

qos_settings

dictionary

Параметры QoS для тома.

Возвращается: при успехе

resource_group_id

integer

Идентификатор группы ресурсов тома.

Возвращается: при успехе

Пример: 0

snapshots

list / elements=dictionary

Список снимков, связанных с томом.

Возвращается: при успехе

Пример: []

ssid

string

Идентификатор подсистемы для томов мейнфрейма.

Возвращается: при успехе

Пример: "000C"

status

string

Текущее состояние тома.

Возвращается: при успехе

Пример: "NML"

storage_serial_number

string

Серийный номер системы хранения данных.

Возвращается: при успехе

Пример: "70033"

tiering_policy

dictionary

Сведения о политике распределения по уровням хранения.

Возвращается: при успехе

Пример: {}

total_capacity

string

Общая ёмкость тома.

Возвращается: при успехе

Пример: "54.71GB"

total_capacity_in_mb

float

Общая ёмкость тома в мегабайтах.

Возвращается: при успехе

Пример: 56023.04

used_capacity

string

Используемая ёмкость тома.

Возвращается: при успехе

Пример: "0.00B"

used_capacity_in_mb

float

Используемая ёмкость тома в мегабайтах.

Возвращается: при успехе

Пример: 0.0

virtual_ldev_id

integer

Идентификатор виртуального логического устройства.

Возвращается: при успехе

Пример: -1

virtual_ldev_id_hex

string

Идентификатор виртуального логического устройства в шестнадцатеричном формате.

Возвращается: при успехе

Пример: ""