Модуль hitachivantara.vspone_block.vsp.hv_snapshot_family_facts — получает сведения о семействе снимков для указанного идентификатора LDEV из систем блочного хранения 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_snapshot_family_facts.

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

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

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

Этот модуль получает сведения о семействе снимков для указанного идентификатора LDEV из систем блочного хранения VSP.
Примеры см. по адресу https://github.com/hitachi-vantara/vspone-block-ansible/blob/main/playbooks/vsp_direct/snapshot_family_facts.yml

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
connection_info словарь / обязательный	Сведения, необходимые для установления соединения с системой хранения.
address строка / обязательный	IP-адрес или имя узла системы хранения.
api_token строка	Токен для работы с заблокированными ресурсами.
connection_type строка	Тип соединения с системой хранения. Варианты: `"direct"` ← (по умолчанию)
password строка	Пароль для аутентификации. Это обязательное поле.
username строка	Имя пользователя для аутентификации. Это обязательное поле.
spec словарь / обязательный	Спецификация данных о семействе снимков, которые необходимо собрать.
ldev_id строка / обязательный	Идентификатор логического устройства (LDEV).

Атрибуты

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

Примечания

Примечание

Тип соединения gateway удалён начиная с версии 3.4.0. Если вам нужен этот тип соединения, используйте более раннюю версию.

Примеры

- name: Gather snapshot family facts
  hitachivantara.vspone_block.vsp.hv_snapshot_family_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    spec:
      ldev_id: '12345'

Возвращаемые факты

Факты, возвращаемые этим модулем, добавляются или обновляются в фактах узла hostvars и могут использоваться по имени, как и любые другие факты узла. Для их использования не требуется регистрация.

Ключ	Описание
snapshots список / элементы=словарь	Список сведений о снимках и томах виртуальных клонов. Возвращается: всегда
is_virtual_clone_parent_volume логическое значение	Указывает, является ли том родительским для виртуального клона. Возвращается: при успешном выполнении Пример: `true`
is_virtual_clone_volume логическое значение	Указывает, является ли том виртуальным клоном. Возвращается: при успешном выполнении Пример: `true`
ldev_id целое число	Идентификатор логического устройства (LDEV) тома снимка или клона. Возвращается: при успешном выполнении Пример: `104`
mu_number целое число	Номер Mirror Unit (MU), связанный со снимком. Возвращается: при успешном выполнении Пример: `3`
parent_ldev_id целое число	Идентификатор LDEV родительского тома. Возвращается: при успешном выполнении Пример: `104`
pool_id целое число	Идентификатор пула, в котором находится снимок или клон. Возвращается: при успешном выполнении Пример: `22`
primary_or_secondary строка	Указывает, является ли том первичным или вторичным. Возвращается: при успешном выполнении Пример: `"P-VOL"`
pvol_ldev_id целое число	Идентификатор LDEV первичного тома. Возвращается: при успешном выполнении Пример: `104`
snapshot_group_id строка	Идентификатор группы снимков. Возвращается: при успешном выполнении Пример: `"test_sp_group"`
snapshot_group_name строка	Имя группы снимков. Возвращается: при успешном выполнении Пример: `"test_sp_group"`
snapshot_id строка	Уникальный идентификатор снимка, обычно в формате LDEV,MU. Возвращается: при успешном выполнении Пример: `"104,3"`
split_time строка	Метка времени, когда снимок был отделён от родительского тома. Возвращается: при успешном выполнении Пример: `"2025-08-28T18:12:39"`
status строка	Текущее состояние снимка или клона. Возвращается: при успешном выполнении Пример: `"PFUS"`

Авторы

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_snapshot_family_facts_module.html