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

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

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

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

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

Требования

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

python >= 3.9

Параметры

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

Атрибуты

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

Примечания

Примечание

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

Примеры

- name: Gather snapshot facts with primary volume and mirror unit ID
  hitachivantara.vspone_block.vsp.hv_snapshot_group_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    spec:
      snapshot_group_name: 'NewNameSPG'

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

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

Ключ	Описание
snapshot_groups dictionary	Сведения о группах снимков. Возвращается: success
snapshot_group_id string	Уникальный идентификатор группы снимков. Возвращается: success Пример: `"spc-snapshot"`
snapshot_group_name string	Имя группы снимков. Возвращается: success Пример: `"spc-snapshot"`
snapshots list / elements=dictionary	Список снимков в группе. Возвращается: success
can_cascade boolean	Указывает, может ли снимок участвовать в каскадировании. Возвращается: success Пример: `true`
concordance_rate integer	Степень согласованности снимка. Возвращается: success Пример: `-1`
copy_pace_track_size string	Размер дорожки для скорости копирования. Возвращается: success Пример: `""`
copy_rate integer	Скорость копирования снимка. Возвращается: success Пример: `-1`
is_clone boolean	Указывает, является ли снимок клоном. Возвращается: success Пример: `false`
is_consistency_group boolean	Указывает, является ли это группой согласованности. Возвращается: success Пример: `false`
is_redirect_on_write boolean	Указывает, включен ли режим перенаправления при записи. Возвращается: success Пример: `true`
is_snapshot_data_read_only boolean	Указывает, доступны ли данные снимка только для чтения. Возвращается: success
is_virtual_clone_parent_volume boolean	Указывает, является ли этот том родительским томом виртуального клона. Возвращается: success Пример: `false`
is_virtual_clone_volume boolean	Указывает, является ли этот том томом виртуального клона. Возвращается: success Пример: `false`
is_written_in_svol boolean	Указывает, записаны ли данные во вторичный том. Возвращается: success Пример: `false`
mirror_unit_id integer	Устарело. Используйте вместо этого mirror_unit_number. Идентификатор зеркального устройства. Возвращается: success Пример: `3`
mirror_unit_number integer	Номер зеркального устройства. Возвращается: success Пример: `3`
pool_id integer	Идентификатор пула. Возвращается: success Пример: `22`
primary_hex_volume_id string	Шестнадцатеричный идентификатор основного тома. Возвращается: success Пример: `"00:03:4A"`
primary_volume_id integer	Идентификатор основного тома. Возвращается: success Пример: `842`
progress_rate integer	Степень выполнения операции со снимком. Возвращается: success Пример: `-1`
pvol_host_groups list / elements=string	Группы хостов для основного тома. Возвращается: success Пример: `[]`
pvol_nvm_subsystem_name string	Имя подсистемы NVM для основного тома. Возвращается: success Пример: `""`
pvol_processing_status string	Состояние обработки основного тома. Возвращается: success Пример: `"N"`
retention_period_in_hours integer	Срок хранения снимка в часах. Возвращается: success Пример: `-1`
secondary_hex_volume_id string	Шестнадцатеричный идентификатор вторичного тома. Возвращается: success Пример: `"00:06:36"`
secondary_volume_id integer	Идентификатор вторичного тома. Возвращается: success Пример: `1590`
snapshot_group_name string	Имя группы снимков. Возвращается: success Пример: `"spc-snapshot"`
snapshot_id string	Идентификатор снимка. Возвращается: success Пример: `"842,3"`
split_time string	Время разделения снимка. Возвращается: success Пример: `"2025-06-27T23:28:06"`
status string	Состояние снимка. Возвращается: success Пример: `"PSUS"`
svol_host_groups list / elements=string	Группы хостов для вторичного тома. Возвращается: success Пример: `[]`
svol_nvm_subsystem_name string	Имя подсистемы NVM для вторичного тома. Возвращается: success Пример: `""`
svol_processing_status string	Состояние обработки вторичного тома. Возвращается: success Пример: `""`
type string	Тип снимка. Возвращается: success Пример: `"CASCADE"`

Авторы

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