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

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

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

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

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

Требования

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

python >= 3.9

Параметры

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

Атрибуты

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

Примечания

Примечание

Выходные параметры entitlement_status, subscriber_id и partner_id удалены в версии 3.4.0. Они также признаны устаревшими из-за упрощения внутреннего API и больше не поддерживаются.
Тип подключения gateway удален начиная с версии 3.4.0. Если вам необходим этот тип подключения, используйте более раннюю версию.
Этот модуль отображает информацию о парах ShadowImage, включая их идентификатор, состояние и другие важные сведения. Получаются только пары, входящие в группу копирования. Поэтому рекомендуется удалить все существующие пары, не входящие в группу копирования, и повторно создать пары репликации с помощью прямого подключения и технологии групп копирования.

Примеры

- name: Retrieve information about all shadow image pairs
  hitachivantara.vspone_block.vsp.hv_shadow_image_pair_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"

    storage_system_info:
      serial: 811150

- name: Retrieve information about a specific shadow image pair
  hitachivantara.vspone_block.vsp.hv_shadow_image_pair_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    spec:
      primary_volume_id: 274

- name: Retrieve information about a specific shadow image pair using copy group name and copy pair name
  hitachivantara.vspone_block.vsp.hv_shadow_image_pair_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    spec:
      copy_group_name: "copy_group_1"
      copy_pair_name: "copy_pair_1"

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

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

Ключ	Описание
data список / элементы=словарь	Список пар ShadowImage. Возвращается: при успешном выполнении
consistency_group_id целое число	Идентификатор группы согласованности. Возвращается: при успешном выполнении Пример: `-1`
copy_group_name строка	Имя группы копирования. Возвращается: при успешном выполнении Пример: `"SI_768"`
copy_pace_track_size строка	Размер дорожки темпа копирования. Возвращается: при успешном выполнении Пример: `"MEDIUM"`
copy_pair_name строка	Имя пары копирования. Возвращается: при успешном выполнении Пример: `"SI_768"`
copy_rate целое число	Скорость копирования. Возвращается: при успешном выполнении Пример: `100`
mirror_unit_id целое число	Устарело. Используйте mirror_unit_number. Возвращается: при успешном выполнении Пример: `0`
mirror_unit_number целое число	Номер модуля зеркалирования. Возвращается: при успешном выполнении Пример: `0`
primary_volume_host_groups список / элементы=словарь	Группы хостов основного тома. Возвращается: при успешном выполнении Пример: `[{"host_group_name": "hostserver1153", "host_group_number": 189, "lun": 0, "port_id": "CL2-B"}]`
primary_volume_id целое число	Идентификатор основного тома. Возвращается: при успешном выполнении Пример: `768`
primary_volume_id_hex строка	Шестнадцатеричный идентификатор основного тома. Возвращается: при успешном выполнении Пример: `"00:03:00"`
primary_volume_iscsi_targets список / элементы=словарь	Цели iSCSI основного тома. Возвращается: при успешном выполнении Пример: `[]`
primary_volume_nvm_subsystem_name строка	Имя подсистемы nvm основного тома. Возвращается: при успешном выполнении Пример: `""`
pvol_host_groups список / элементы=словарь	Устарело. Используйте primary_volume_host_groups. Возвращается: при успешном выполнении Пример: `[{"host_group_name": "hostserver1153", "host_group_number": 189, "lun": 0, "port_id": "CL2-B"}]`
pvol_iscsi_targets список / элементы=словарь	Устарело. Используйте primary_volume_iscsi_targets. Возвращается: при успешном выполнении Пример: `[]`
pvol_nvm_subsystem_name строка	Устарело. Используйте primary_volume_nvm_subsystem_name. Возвращается: при успешном выполнении Пример: `""`
secondary_volume_host_groups список / элементы=словарь	Группы хостов вторичного тома. Возвращается: при успешном выполнении Пример: `[{"host_group_name": "hostserver1153", "host_group_number": 189, "lun": 1, "port_id": "CL2-B"}]`
secondary_volume_id целое число	Идентификатор вторичного тома. Возвращается: при успешном выполнении Пример: `771`
secondary_volume_id_hex строка	Шестнадцатеричный идентификатор вторичного тома. Возвращается: при успешном выполнении Пример: `"00:03:03"`
secondary_volume_iscsi_targets список / элементы=словарь	Цели iSCSI вторичного тома. Возвращается: при успешном выполнении Пример: `[]`
secondary_volume_nvm_subsystem_name строка	Имя подсистемы nvm вторичного тома. Возвращается: при успешном выполнении Пример: `""`
status строка	Состояние пары ShadowImage. Возвращается: при успешном выполнении Пример: `"PAIR"`
storage_serial_number строка	Серийный номер системы хранения. Возвращается: при успешном выполнении Пример: `"810045"`
svol_host_groups список / элементы=словарь	Устарело. Используйте secondary_volume_host_groups. Возвращается: при успешном выполнении Пример: `[{"host_group_name": "hostserver1153", "host_group_number": 189, "lun": 1, "port_id": "CL2-B"}]`
svol_iscsi_targets список / элементы=словарь	Устарело. Используйте secondary_volume_iscsi_targets. Возвращается: при успешном выполнении Пример: `[]`
svol_nvm_subsystem_name строка	Устарело. Используйте secondary_volume_nvm_subsystem_name. Возвращается: при успешном выполнении Пример: `""`

Авторы

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