Модуль hitachivantara.vspone_block.vsp.hv_vsp_one_snapshot_facts – получает сведения о снимках систем хранения VSP E series, VSP One Block 20 series и VSP One Block 80 series.

Примечание

Этот модуль входит в коллекцию 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_vsp_one_snapshot_facts.

Новое в hitachivantara.vspone_block 4.4.0

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

Описание

Этот модуль получает сведения о снимках систем хранения VSP E series, VSP One Block 20 series и VSP One Block 80 series.
Использует простой API Hitachi Virtual Storage Platform One для получения фактов о снимках в моделях VSP One B20 series, VSP One B80 series и VSP E series.
Примеры использования см. по адресу https://github.com/hitachi-vantara/vspone-block-ansible/blob/main/playbooks/vsp_direct/vsp_one_snapshot_facts.yml

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
connection_info dictionary / обязательный	Сведения, необходимые для подключения к системе хранения.
address string / обязательный	IP-адрес или имя узла системы хранения.
api_token string	Токен для работы с заблокированными ресурсами.
password string	Пароль для аутентификации. Это обязательное поле.
username string	Имя пользователя для аутентификации. Это обязательное поле.
spec dictionary	Параметры запроса для получения сведений о снимках.
count integer	Укажите количество снимков значением от 1 до 1000. Если параметр не указан, используется значение 1000.
master_volume_id string	Идентификатор основного тома снимка.
snapshot_date_from string	Будут получены сведения о снимках, созданных в указанную дату и время или позднее. Укажите дату и время начала получения снимков в формате YYYY-MM-DDThh:mm:ssZ.
snapshot_date_to string	Будут получены сведения о снимках, созданных в указанную дату и время или ранее. Укажите дату и время начала получения снимков в формате YYYY-MM-DDThh:mm:ssZ.
snapshot_group_name string	Имя группы снимков. Будут получены сведения о снимке, полностью совпадающем с указанным значением.
snapshot_id integer	Идентификатор снимка.
start_id string	Укажите сведения о первом снимке, которые нужно получить, задав через запятую идентификатор основного тома снимка и идентификатор снимка. Строка в формате ‘master_volume_id,snapshot_id’. Если параметр не указан, используется значение ‘0,0’.

Атрибуты

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

Примеры

- name: Get snapshot pair with master_volume_id and snapshot_id
  hitachivantara.vspone_block.vsp.hv_vsp_one_snapshot_facts:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      master_volume_id: 1445
      snapshot_id: 4

- name: Get all snapshot pairs
  hitachivantara.vspone_block.vsp.hv_vsp_one_snapshot_facts:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"

- name: Get port information by protocol
  hitachivantara.vspone_block.vsp.hv_vsp_one_snapshot_facts:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      protocol: "fc"

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

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

Ключ	Описание
snapshots list / elements=dictionary	Список сведений о снимках, полученных из системы хранения. Возвращается: всегда
id string	Идентификаторы основного тома и снимка, разделённые запятой. Возвращается: при успешном выполнении Пример: `"1445,4"`
is_volume_capacity_expanding boolean	Указывает, увеличивается ли ёмкость основного тома. Возвращается: при успешном выполнении Пример: `false`
mapped_volume_id integer	Идентификатор тома, создаваемого на основе снимков. Этот атрибут возвращается только в том случае, если указан идентификатор тома, для которого создан снимок. Возвращается: при успешном выполнении Пример: `1445`
mapped_volume_id_hex string	Шестнадцатеричный идентификатор сопоставленного тома снимка. Возвращается: при успешном выполнении Пример: `"00:05:A5"`
master_volume_id integer	Идентификатор основного тома снимка. Возвращается: при успешном выполнении Пример: `1445`
master_volume_id_hex string	Шестнадцатеричный идентификатор основного тома снимка. Возвращается: при успешном выполнении Пример: `"00:05:A5"`
pool_id integer	Идентификатор пула, в котором хранятся дифференциальные данные снимков. Возвращается: при успешном выполнении Пример: `1`
retention_period integer	Оставшееся время хранения снимка (в часах). Если срок хранения данных снимка не задан или истёк, возвращается значение 0. Возвращается: при успешном выполнении Пример: `0`
root_volume_id integer	Идентификатор корневого тома снимков. Возвращается: при успешном выполнении Пример: `104`
root_volume_id_hex string	Шестнадцатеричный идентификатор корневого тома снимков. Возвращается: при успешном выполнении Пример: `"00:00:68"`
snapshot_date string	Дата и время создания снимка. Возвращается: при успешном выполнении Пример: `"2025-08-28T18:12:39Z"`
snapshot_group_name string	Имя группы снимков. Возвращается: при успешном выполнении Пример: `"test_sp_group"`
snapshot_id integer	Идентификатор снимка. Возвращается номер зеркального устройства. Возвращается: при успешном выполнении Пример: `3`
status string	Состояние снимка. Возвращается: при успешном выполнении Пример: `"Completed"`
type string	Тип снимка. Возвращается: при успешном выполнении Пример: `"Snapshot"`
used_capacity_in_mb_per_root_volume integer	Объём дискового пространства (МиБ), занимаемый дифференциальными и управляющими данными, используемыми группой снимков, созданной из того же тома. Возвращается: при успешном выполнении Пример: `0`

Авторы

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