Модуль hitachivantara.vspone_block.vsp.hv_storagepool — управление информацией о пулах хранения в блочных системах хранения VSP.

Примечание

Этот модуль входит в коллекцию hitachivantara.vspone_block (версия 4.8.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install hitachivantara.vspone_block. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: hitachivantara.vspone_block.vsp.hv_storagepool.

Добавлено в hitachivantara.vspone_block 3.1.0

Краткое описание
Требования
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

Краткое описание

Создание, обновление и удаление информации о пулах хранения в блочных системах хранения VSP.
Примеры см. по адресу https://github.com/hitachi-vantara/vspone-block-ansible/blob/main/playbooks/vsp_direct/storagepool.yml

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
connection_info словарь / обязательный	Информация, необходимая для установления соединения с системой хранения.
address строка / обязательный	IP-адрес или имя узла системы хранения.
api_token строка	Токен для работы с заблокированными ресурсами.
connection_type строка	Тип соединения с системой хранения. Допустимые значения: `"direct"` ← (по умолчанию)
password строка	Пароль для аутентификации. Обязательное поле.
username строка	Имя пользователя для аутентификации. Обязательное поле.
spec словарь	Параметры пула хранения.
blocking_mode строка	Настройка функции защиты виртуального тома. Обязательный параметр для задачи «Изменение настроек пула по имени с новыми параметрами». Необязательный параметр для задачи «Изменение настроек пула по идентификатору с новыми параметрами». Допустимые значения: `"PF"` `"PB"` `"FB"` `"NB"`
depletion_threshold_rate целое число	Пороговое значение заполнения пула (не применяется к пулу Thin Image). Обязательный параметр для задач «Создание пула хранения с дополнительными сведениями» и «Изменение настроек пула по имени с новыми параметрами». Необязательный параметр для задач «Создание пула Thin Image» и «Изменение настроек пула по идентификатору с новыми параметрами».
end_ldev_id строка	Последний номер LDEV в диапазоне последовательных номеров LDEV, если указан такой диапазон. Обязательный параметр для задачи «Создание пула хранения с заданным идентификатором пула и начальным и конечным номерами LDEV». Может быть десятичным или шестнадцатеричным числом.
end_pool_volume_id строка	Последний идентификатор тома пула в диапазоне последовательных идентификаторов томов пула, которые необходимо удалить из пула. Обязательный параметр для задачи «Уменьшение пула».
id целое число	Идентификатор пула. Обязательный параметр для задач «Создание пула хранения с заданным идентификатором пула и номерами LDEV» / «Создание пула хранения с заданным идентификатором пула и начальным и конечным номерами LDEV» / «Расширение пула по идентификатору пула» / «Удаление пула по идентификатору пула» / «Мониторинг производительности пула» / «Перемещение уровней пула» / «Восстановление пула» / «Инициализация функции экономии емкости пула» / «Изменение настроек пула по идентификатору с новыми параметрами».
ldev_ids список / элементы=строка	Номера LDEV. Могут быть десятичными или шестнадцатеричными числами. Обязательный параметр для задачи «Создание пула хранения с заданным идентификатором пула и номерами LDEV».
monitoring_mode строка	Режим выполнения мониторинга производительности (режим мониторинга) для типа HDT. Обязательный параметр для задачи «Изменение настроек пула по имени с новыми параметрами». Необязательный параметр для задачи «Изменение настроек пула по идентификатору с новыми параметрами». Допустимые значения: `"PM"` `"CM"`
name строка	Имя пула. Обязательный параметр для задач «Создание пула хранения с обязательными сведениями» / «Создание пула хранения с дополнительными сведениями» / «Создание пула хранения с заданным идентификатором пула и номерами LDEV» / «Создание пула хранения с заданным идентификатором пула и начальным и конечным номерами LDEV» / «Создание пула Thin Image» / «Расширение пула по имени пула» / «Удаление пула по имени пула» / «Удаление пула вместе с томами пула» / «Изменение настроек пула по имени с новыми параметрами». Необязательный параметр для задачи «Изменение настроек пула по идентификатору с новыми параметрами».
operation_type строка	Укажите операцию перемещения уровней и мониторинга производительности. Обязательный параметр для задач «Мониторинг производительности пула» / «Перемещение уровней пула». Допустимые значения: `"start"` `"stop"`
pool_volume_ids список / элементы=строка	Список идентификаторов томов пула, которые необходимо удалить из пула. Обязательный параметр для задачи «Уменьшение пула».
pool_volumes список / элементы=словарь	Сведения о томах в пуле. Обязательный параметр для задач «Создание пула хранения с обязательными сведениями» / «Создание пула хранения с дополнительными сведениями» / «Создание пула Thin Image» / «Расширение пула по имени пула» / «Расширение пула по идентификатору пула».
capacity строка	Емкость тома пула. Обязательный параметр для задач «Создание пула хранения с обязательными сведениями» / «Создание пула хранения с дополнительными сведениями» / «Создание пула Thin Image» / «Расширение пула по имени пула» / «Расширение пула по идентификатору пула».
cylinder целое число	Размер цилиндра тома пула.
parity_group_id строка / обязательный	Идентификатор группы четности, к которой относится том. Обязательный параметр для задач «Создание пула хранения с обязательными сведениями» / «Создание пула хранения с дополнительными сведениями» / «Создание пула Thin Image» / «Расширение пула по имени пула» / «Расширение пула по идентификатору пула».
resource_group_id целое число	Идентификатор группы ресурсов, к которой относится пул. Необязательный параметр для задач «Создание пула хранения с дополнительными сведениями» / «Создание пула Thin Image».
should_delete_pool_volumes логическое значение	Следует ли удалять тома пула при удалении пула. Обязательный параметр для задачи «Удаление пула вместе с томами пула». Допустимые значения: `false` `true`
should_enable_deduplication логическое значение	Следует ли включить дедупликацию для пула. Эта функция доступна для следующих моделей: VSP G200 VSP G400 VSP F400 VSP G600 VSP F600 VSP G800 VSP F800 VSP G400 с модулем NAS VSP G600 с модулем NAS VSP G800 с модулем NAS VSP G1000 VSP G1500 VSP F1500 VSP N400 VSP N600 Необязательный параметр для задач «Создание пула хранения с дополнительными сведениями» / «Создание пула Thin Image». Допустимые значения: `false` `true`
should_stop_shrinking логическое значение	Следует ли остановить уменьшение пула. Обязательный параметр для задачи «Уменьшение пула». Допустимые значения: `false` `true`
start_ldev_id строка	Первый номер LDEV в диапазоне последовательных номеров LDEV, если указан такой диапазон. Обязательный параметр для задачи «Создание пула хранения с заданным идентификатором пула и начальным и конечным номерами LDEV». Может быть десятичным или шестнадцатеричным числом.
start_pool_volume_id строка	Первый идентификатор тома пула в диапазоне последовательных идентификаторов томов пула, которые необходимо удалить из пула. Обязательный параметр для задачи «Уменьшение пула».
suspend_snapshot логическое значение	Следует ли приостанавливать пары Thin Image при превышении порогового значения заполнения. Обязательный параметр для задачи «Изменение настроек пула по имени с новыми параметрами». Необязательный параметр для задачи «Изменение настроек пула по идентификатору с новыми параметрами». Допустимые значения: `false` `true`
tier словарь	Атрибут уровня пула HDT. Обязательный параметр для задачи «Изменение настроек пула по имени с новыми параметрами». Необязательный параметр для задачи «Изменение настроек пула по идентификатору с новыми параметрами».
buffer_rate целое число	Доля буферных областей для перераспределения (в процентах). Обязательный параметр для задач «Изменение настроек пула по имени с новыми параметрами» / «Изменение настроек пула по идентификатору с новыми параметрами».
table_space_rate целое число	Доля свободного пространства для нового распределения по уровням (в процентах). Обязательный параметр для задач «Изменение настроек пула по имени с новыми параметрами» / «Изменение настроек пула по идентификатору с новыми параметрами».
tier_number целое число	Номер уровня пула. Обязательный параметр для задач «Изменение настроек пула по имени с новыми параметрами» / «Изменение настроек пула по идентификатору с новыми параметрами».
type строка	Тип пула. Поддерживаются типы `HDT`, `HDP`, `HRT`, `HTI`. Обязательный параметр для задач «Создание пула хранения с обязательными сведениями» / «Создание пула хранения с дополнительными сведениями» / «Создание пула хранения с заданным идентификатором пула и номерами LDEV» / «Создание пула хранения с заданным идентификатором пула и начальным и конечным номерами LDEV» / «Создание пула Thin Image». Необязательный параметр для задачи «Изменение настроек пула по идентификатору с новыми параметрами». Допустимые значения: `"HDT"` `"HDP"` `"HRT"` `"HTI"`
virtual_volume_capacity_rate целое число	Лимит подписки виртуального тома на емкость пула (%). Обязательный параметр для задачи «Изменение настроек пула по имени с новыми параметрами». Необязательный параметр для задачи «Изменение настроек пула по идентификатору с новыми параметрами».
warning_threshold_rate целое число	Пороговое значение предупреждения для пула. Обязательный параметр для задач «Создание пула хранения с дополнительными сведениями» / «Создание пула Thin Image» / «Изменение настроек пула по имени с новыми параметрами». Необязательный параметр для задачи «Изменение настроек пула по идентификатору с новыми параметрами».
state строка	Уровень задачи для пула хранения. Допустимые значения: `present`, `absent`, `restore`, `tier_relocate`, `monitor_performance`, `init_capacity_saving`. Если необходимо выполнить операцию с пулом `restore`, она требуется, когда пул заблокирован из-за потери энергозависимости общей памяти. Допустимые значения: `"present"` ← (по умолчанию) `"absent"` `"restore"` `"tier_relocate"` `"monitor_performance"` `"init_capacity_saving"` `"shrunk"`
storage_system_info словарь	Информация о системе хранения. Это поле является необязательным.
serial строка	Серийный номер системы хранения.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: отсутствует	Определяет, должен ли модуль выполняться в режиме проверки.

Примечания

Примечание

Выходные параметры subscriber_id и partner_id удалены в версии 3.4.0. Они также объявлены устаревшими из-за упрощения внутреннего API и больше не поддерживаются.
Тип соединения gateway удален начиная с версии 3.4.0. Если вам необходим этот тип соединения, используйте более раннюю версию.

Примеры

- name: Create a Storage Pool
  hitachivantara.vspone_block.vsp.hv_storagepool:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: "present"
    spec:
      name: "test_pool"
      type: "HDP"
      should_enable_deduplication: true
      depletion_threshold_rate: 80
      warning_threshold_rate: 70
      resource_group_id: 0
      pool_volumes:
        - capacity: "21.00 GB"
          parity_group_id: "1-2"

- name: Delete a Storage Pool by pool name
  hitachivantara.vspone_block.vsp.hv_storagepool:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: "absent"
    spec:
      name: "test_pool"

- name: Delete a Storage Pool including its volumes
  hitachivantara.vspone_block.vsp.hv_storagepool:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: "absent"
    spec:
      name: "test_pool"
      should_delete_pool_volumes: true

- name: Performing performance monitoring of a pool
  hitachivantara.vspone_block.vsp.hv_storagepool:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: "monitor_performance"
    spec:
      id: 48
      operation_type: "start"

- name: Performing tier relocation of a pool
  hitachivantara.vspone_block.vsp.hv_storagepool:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: "relocate"
    spec:
      id: 48
      operation_type: "start"

- name: Restoring a pool
  hitachivantara.vspone_block.vsp.hv_storagepool:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: "restore"
    spec:
      id: 48

- name: Initializing the capacity saving function for a pool
  hitachivantara.vspone_block.vsp.hv_storagepool:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: "init_capacity_saving"
    spec:
      id: 48

- name: Update an existing Storage Pool
  hitachivantara.vspone_block.vsp.hv_storagepool:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: "present"
    spec:
      name: "test_pool"
      warning_threshold_rate: 75
      depletion_threshold_rate: 85

- name: Update Storage Pool with new parameters
  hitachivantara.vspone_block.vsp.hv_storagepool:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: "present"
    spec:
      name: "test_pool"
      warning_threshold_rate: 78
      depletion_threshold_rate: 88
      virtual_volume_capacity_rate: 90
      monitoring_mode: "PF"
      blocking_mode: "PM"
      suspend_snapshot: true
      tier:
        tier_number: 1
        tablespace_rate: 60
        buffer_rate: 20

Возвращаемые значения

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

Ключ	Описание
storage_pool list / elements=dictionary	Информация о пуле хранения. Возвращается: всегда
auto_add_pool_vol string	Настройка автоматического добавления тома в пул. Возвращается: при успешном выполнении Пример: `""`
available_physical_volume_capacity_mb integer	Доступная емкость физических томов в МБ. Возвращается: при успешном выполнении Пример: `14591094`
available_volume_capacity_mb integer	Доступная емкость томов в МБ. Возвращается: при успешном выполнении Пример: `14591094`
blocking_mode string	Режим блокировки пула. Возвращается: при успешном выполнении Пример: `"NB"`
capacities_excluding_system_data dictionary	Информация о емкости без учета системных данных. Возвращается: при успешном выполнении
compressed_capacity integer	Емкость после сжатия. Возвращается: при успешном выполнении Пример: `0`
deduped_capacity integer	Емкость после дедупликации. Возвращается: при успешном выполнении Пример: `0`
pre_compressed_capacity integer	Емкость до сжатия. Возвращается: при успешном выполнении Пример: `0`
pre_dedupred_capacity integer	Емкость до дедупликации. Возвращается: при успешном выполнении Пример: `0`
pre_used_capacity integer	Емкость до использования. Возвращается: при успешном выполнении Пример: `0`
reclaimed_capacity integer	Возвращенная емкость. Возвращается: при успешном выполнении Пример: `0`
system_data_capacity integer	Емкость системных данных. Возвращается: при успешном выполнении Пример: `1118208`
used_virtual_volume_capacity integer	Используемая емкость виртуальных томов. Возвращается: при успешном выполнении Пример: `258048`
compression_rate integer	Коэффициент сжатия. Возвращается: при успешном выполнении Пример: `0`
dat string	Информация DAT. Возвращается: при успешном выполнении Пример: `""`
data_reduction_accelerate_comp_capacity_mb integer	Емкость сжатия при ускоренном сокращении объема данных в МБ. Возвращается: при успешном выполнении Пример: `0`
data_reduction_accelerate_comp_including_system_data dictionary	Ускоренное сжатие при сокращении объема данных, включая системные данные. Возвращается: при успешном выполнении
is_reduction_capacity_available boolean	Доступна ли емкость сокращения объема данных. Возвращается: при успешном выполнении Пример: `false`
is_reduction_rate_available boolean	Доступен ли коэффициент сокращения объема данных. Возвращается: при успешном выполнении Пример: `false`
reduction_capacity integer	Емкость сокращения объема данных. Возвращается: при успешном выполнении Пример: `-1`
reduction_rate integer	Коэффициент сокращения объема данных. Возвращается: при успешном выполнении Пример: `-1`
data_reduction_accelerate_comp_rate integer	Коэффициент сжатия при ускоренном сокращении объема данных. Возвращается: при успешном выполнении Пример: `0`
data_reduction_before_capacity_mb integer	Емкость до сокращения объема данных в МБ. Возвращается: при успешном выполнении Пример: `0`
data_reduction_capacity_mb integer	Емкость сокращения объема данных в МБ. Возвращается: при успешном выполнении Пример: `0`
data_reduction_including_system_data dictionary	Сокращение объема данных, включая системные данные. Возвращается: при успешном выполнении
is_reduction_capacity_available boolean	Доступна ли емкость сокращения объема данных. Возвращается: при успешном выполнении Пример: `false`
is_reduction_rate_available boolean	Доступен ли коэффициент сокращения объема данных. Возвращается: при успешном выполнении Пример: `false`
reduction_capacity integer	Емкость сокращения объема данных. Возвращается: при успешном выполнении Пример: `-1`
reduction_rate integer	Коэффициент сокращения объема данных. Возвращается: при успешном выполнении Пример: `-1`
data_reduction_rate integer	Коэффициент сокращения объема данных. Возвращается: при успешном выполнении Пример: `0`
depletion_threshold integer	Порог истощения. Возвращается: при успешном выполнении Пример: `80`
duplication_ldev_ids list / elements=integer	Список идентификаторов LDEV для дублирования. Возвращается: при успешном выполнении Пример: `[32731, 32730, 32729, 32728]`
duplication_ldev_ids_hex list / elements=string	Список идентификаторов LDEV для дублирования в шестнадцатеричном формате. Возвращается: при успешном выполнении Пример: `["00:7F:DB", "00:7F:DA", "00:7F:D9", "00:7F:D8"]`
duplication_number integer	Количество дубликатов. Возвращается: при успешном выполнении Пример: `8`
duplication_rate integer	Коэффициент дублирования. Возвращается: при успешном выполнении Пример: `0`
effective_capacity_mb integer	Эффективная емкость в МБ. Возвращается: при успешном выполнении Пример: `14591766`
efficiency integer	Показатель эффективности. Возвращается: при успешном выполнении
first_ldev_id integer	Первый идентификатор LDEV. Возвращается: при успешном выполнении Пример: `32754`
formatted_capacity integer	Отформатированная емкость. Возвращается: при успешном выполнении Пример: `-1`
has_blocked_pool_volume boolean	Есть ли в пуле заблокированный том пула. Возвращается: при успешном выполнении
is_compression_acceleration_available boolean	Указывает, доступно ли ускорение сжатия. Возвращается: при успешном выполнении Пример: `true`
is_mainframe boolean	Предназначен ли пул для мейнфрейма. Возвращается: при успешном выполнении Пример: `false`
is_shrinking boolean	Выполняется ли уменьшение пула. Возвращается: при успешном выполнении Пример: `false`
located_volume_count integer	Количество обнаруженных томов. Возвращается: при успешном выполнении Пример: `29`

monitoring_mode string	Режим мониторинга. Возвращается: при успехе Пример: `""`
num_of_ldevs integer	Количество LDEV. Возвращается: при успехе Пример: `12`
pool_action_mode string	Режим действий с пулом. Возвращается: при успехе Пример: `""`
pool_id integer	Идентификатор пула. Возвращается: при успехе Пример: `0`
pool_name string	Имя пула. Возвращается: при успехе Пример: `"test-ddp-pool_1"`
pool_status string	Состояние пула. Возвращается: при успехе Пример: `"NORMAL"`
pool_type string	Тип пула. Возвращается: при успехе Пример: `"HDP"`
reserved_volume_count integer	Количество зарезервированных томов. Возвращается: при успехе Пример: `0`
snapshot_count integer	Количество снимков. Возвращается: при успехе Пример: `1`
snapshot_used_capacity_mb integer	Используемая снимками емкость в МБ. Возвращается: при успехе Пример: `0`
suspend_snapshot boolean	Приостановлено ли создание снимков. Возвращается: при успехе Пример: `true`
tier_operation_status string	Состояние операции с уровнями. Возвращается: при успехе Пример: `""`
tiers list / элементы=dictionary	Список уровней. Возвращается: при успехе Пример: `[]`
total_located_capacity_mb integer	Общая размещенная емкость в МБ. Возвращается: при успехе Пример: `33597984`
total_physical_capacity_mb integer	Общая физическая емкость в МБ. Возвращается: при успехе Пример: `14591766`
total_pool_capacity_mb integer	Общая емкость пула в МБ. Возвращается: при успехе Пример: `14591766`
total_reserved_capacity_mb integer	Общая зарезервированная емкость в МБ. Возвращается: при успехе Пример: `0`
used_capacity_rate integer	Коэффициент использования емкости. Возвращается: при успехе Пример: `1`
used_physical_capacity integer	Используемая физическая емкость. Возвращается: при успехе Пример: `-1`
used_physical_capacity_rate integer	Коэффициент использования физической емкости. Возвращается: при успехе Пример: `1`
virtual_volume_capacity_rate integer	Коэффициент использования емкости виртуальных томов. Возвращается: при успехе Пример: `-1`
warning_threshold integer	Порог предупреждения. Возвращается: при успехе Пример: `70`

Авторы

Hitachi Vantara LTD (@hitachi-vantara)

Ссылки на коллекцию

© 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/hitachivantara/vspone_block/vsp.hv_storagepool_module.html