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

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

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

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

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

Требования

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

python >= 3.9

Параметры

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

Атрибуты

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

Примечания

Примечание

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

Примеры

- name: Get all TrueCopy 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: Retrieve TrueCopy pair information for a specific volume
  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"
    spec:
      primary_volume_id: 123

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

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

Ключ	Описание
truecopy_pairs list / elements=dictionary	Список сведений о парах TrueCopy. Возвращается: при успехе
consistency_group_id string	Идентификатор группы согласованности. Возвращается: при успехе Пример: `""`
copy_group_name string	Имя группы копирования. Возвращается: при успехе Пример: `"cp_group_840"`
copy_pair_name string	Имя пары копирования. Возвращается: при успехе Пример: `"gad_pair_840"`
copy_progress_rate integer	Устарело. Скорость выполнения копирования. Возвращается: при успехе Пример: `-1`
fence_level string	Уровень ограждения. Возвращается: при успехе Пример: `"NEVER"`
local_device_group_name string	Имя локальной группы устройств, для которой требуется получить сведения о паре TrueCopy. Возвращается: при успехе Пример: `"tc_bulk_cg_1P_"`
primary_volume_id integer	Идентификатор основного тома. Возвращается: при успехе Пример: `840`
primary_volume_id_hex string	Идентификатор основного тома в шестнадцатеричном формате. Возвращается: при успехе Пример: `"00:03:48"`
primary_volume_size string	Размер основного тома. Отображается только при запросе одной пары TrueCopy. Возвращается: при успехе Пример: `"4.00GB"`
primary_volume_status string	Состояние основного тома. Возвращается: при успехе Пример: `"PAIR"`
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. Возвращается: при успехе Пример: `"tc_bulk_cg_1S_"`
remote_mirror_copy_pair_id string	Устарело. Идентификатор пары копирования удалённого зеркала. Возвращается: при успехе Пример: `"A34000810050,cp_group_840,cp_group_840S_,cp_group_840P_,gad_pair_840"`
secondary_volume_id integer	Идентификатор вторичного тома. Возвращается: при успехе Пример: `831`
secondary_volume_id_hex string	Идентификатор вторичного тома в шестнадцатеричном формате. Возвращается: при успехе Пример: `"00:03:3F"`
secondary_volume_size string	Размер вторичного тома. Отображается только при запросе одной пары TrueCopy. Возвращается: при успехе Пример: `"4.00GB"`
secondary_volume_status string	Состояние вторичного тома. Возвращается: при успехе Пример: `"PAIR"`
secondary_volume_storage_serial_number string	Серийный номер системы хранения вторичного тома. Возвращается: при успехе Пример: `"810045"`
storage_serial_number string	Устарело. Используйте primary_volume_storage_serial_number. Возвращается: при успехе Пример: `"810050"`
svol_status string	Устарело. Используйте secondary_volume_status. Возвращается: при успехе Пример: `"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_truecopy_facts_module.html