Модуль hitachivantara.vspone_block.vsp.hv_hur_facts — получение информации о HUR из блочных систем хранения данных 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_hur_facts.

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

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

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

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

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
connection_info словарь / обязательный	Сведения, необходимые для подключения к системе хранения данных.
address строка / обязательный	IP-адрес или имя хоста системы хранения данных.
api_token строка	Токен для работы с заблокированными ресурсами.
connection_type строка	Тип подключения к системе хранения данных. Варианты: `"direct"` ← (по умолчанию)
password строка	Пароль для аутентификации. Это обязательное поле.
username строка	Имя пользователя для аутентификации. Это обязательное поле.
secondary_connection_info словарь	Сведения, необходимые для подключения к вторичной системе хранения данных.
address строка / обязательный	IP-адрес или имя хоста вторичной системы хранения данных.
api_token строка	Значение токена блокировки для работы с заблокированными ресурсами.
password строка	Пароль для аутентификации во вторичной системе хранения данных, если api_token не указан.
username строка	Имя пользователя для аутентификации во вторичной системе хранения данных, если api_token не указан.
spec словарь	Спецификация фактов HUR, которые необходимо собрать.
copy_group_name строка	Имя группы копирования. Если не указано, параметр будет опущен. Обязательно для задач получения пары HUR с использованием группы копирования и получения пары HUR с использованием группы копирования и имени пары копирования.
copy_pair_name строка	Имя пары копирования. Если не указано, параметр будет опущен. Обязательно для задачи получения пары HUR с использованием группы копирования и имени пары копирования.
local_device_group_name строка	Имя локальной группы устройств. Если не указано, параметр будет опущен.
mirror_unit_number псевдонимы: mirror_unit_id целое число	Номер зеркального устройства. Если не указан, параметр будет опущен. Варианты: `0` `1` `2` `3`
primary_volume_id строка	Идентификатор первичного тома. Если не указан, параметр будет опущен. Обязательно для задачи получения пары HUR по идентификатору первичного тома.
remote_device_group_name строка	Имя удалённой группы устройств. Если не указано, параметр будет опущен.
secondary_storage_serial_number целое число	Серийный номер вторичной системы хранения данных. Если не указан, параметр будет опущен.
secondary_volume_id строка	Идентификатор вторичного тома. Если не указан, параметр будет опущен. Необязателен для задачи получения пары HUR по идентификатору вторичного тома.
storage_system_info словарь	Сведения о системе хранения данных. Это необязательное поле.
serial строка	Серийный номер системы хранения данных.

Атрибуты

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

Примечания

Примечание

Тип подключения gateway удалён начиная с версии 3.4.0. Если вам требуется этот тип подключения, используйте более раннюю версию.
В настоящее время извлекаются только пары, входящие в группу копирования. Поэтому рекомендуется удалить все существующие пары, не входящие в группу копирования, и заново создать пары репликации, используя технологию прямого подключения с группой копирования.
При работе с фактами удалённой репликации (GAD, HUR, TC) рекомендуется использовать задачу, в которой указано имя группы копирования. Например, получение пары HUR с использованием группы копирования.

Примеры

- name: Get all HUR pairs
  hitachivantara.vspone_block.vsp.hv_truecopy_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"

- name: Gather HUR facts with primary volume and mirror unit ID
  hitachivantara.vspone_block.vsp.hv_hur_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      primary_volume_id: 111
      mirror_unit_number: 10

- name: Gather HUR facts for a specific primary volume
  hitachivantara.vspone_block.vsp.hv_hur_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      primary_volume_id: 111

- name: Gather HUR facts for a specific secondary volume
  hitachivantara.vspone_block.vsp.hv_hur_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    secondary_connection_info:
      address: storage2.company.com
      username: "admin"
      password: "secret"
    spec:
      secondary_volume_id: 111

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

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

Ключ	Описание
hurs list / elements=dictionary	Список HUR, полученных из системы хранения данных. Возвращается: при успехе
consistency_group_id integer	Идентификатор группы согласованности. Возвращается: при успехе Пример: `39`
copy_group_name string	Имя группы копирования. Возвращается: при успехе Пример: `"spcA34000810045A34000810050"`
copy_pair_name string	Имя пары копирования. Возвращается: при успехе Пример: `"spc-7331-6442"`
copy_rate integer	Устарело. Скорость копирования. Возвращается: при успехе Пример: `-1`
fence_level string	Уровень блокировки. Возвращается: при успехе Пример: `"ASYNC"`
local_device_group_name string	Имя локальной группы устройств, для которой требуется получить сведения о паре TrueCopy. Возвращается: при успехе Пример: `"hur_bulk_cg_1P_"`
mirror_unit_id integer	Устарело. Используйте вместо этого mirror_unit_number. Возвращается: при успехе Пример: `1`
mirror_unit_number integer	Номер блока зеркалирования. Возвращается: при успехе Пример: `1`
primary_journal_id integer	Идентификатор основного журнала. Возвращается: при успехе Пример: `25`
primary_journal_pool integer	Устарело. Используйте вместо этого primary_journal_id. Возвращается: при успехе Пример: `25`
primary_volume_id integer	Идентификатор основного тома. Возвращается: при успехе Пример: `6442`
primary_volume_id_hex string	Шестнадцатеричное представление идентификатора основного тома. Возвращается: при успехе Пример: `"00:19:2A"`
primary_volume_status string	Состояние основного тома. Возвращается: при успехе Пример: `"PAIR"`
primary_volume_storage_id string	Устарело. Используйте вместо этого primary_volume_storage_serial_number. Возвращается: при успехе Пример: `"810050"`
primary_volume_storage_serial_number string	Серийный номер системы хранения данных основного тома. Возвращается: при успехе Пример: `"810050"`
pvol_status string	Устарело. Используйте вместо этого primary_volume_status. Возвращается: при успехе Пример: `"PAIR"`
pvol_storage_device_id string	Устарело. Идентификатор устройства хранения PVOL. Возвращается: при успехе Пример: `"A34000810050"`
remote_device_group_name string	Имя удалённой группы устройств, для которой требуется получить сведения о паре TrueCopy. Возвращается: при успехе Пример: `"hur_bulk_cg_1S_"`
remote_mirror_copy_pair_id string	Устарело. Идентификатор пары копирования удалённого зеркала. Возвращается: при успехе Пример: `"A34000810050,spcA34000810045A34000810050,spcA34000810045A34000810050,spcA34000810050A34000810045,spc-7331-6442"`
secondary_journal_id integer	Идентификатор вторичного журнала. Возвращается: при успехе Пример: `25`
secondary_journal_pool integer	Устарело. Используйте вместо этого secondary_journal_id. Возвращается: при успехе Пример: `25`
secondary_volume_id integer	Идентификатор вторичного тома. Возвращается: при успехе Пример: `7331`
secondary_volume_id_hex string	Шестнадцатеричное представление идентификатора вторичного тома. Возвращается: при успехе Пример: `"00:1C:A3"`
secondary_volume_storage_id string	Устарело. Используйте вместо этого secondary_volume_storage_serial_number. Возвращается: при успехе Пример: `"810045"`
secondary_volume_storage_serial_number string	Серийный номер системы хранения данных вторичного тома. Возвращается: при успехе Пример: `"810045"`
svol_status string	Состояние SVOL. Возвращается: при успехе Пример: `"PAIR"`
svol_storage_device_id string	Устарело. Идентификатор устройства хранения SVOL. Возвращается: при успехе Пример: `"A34000810045"`

Авторы

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