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

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

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

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

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

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
connection_info словарь / обязательный	Данные, необходимые для подключения к системе хранения данных.
address строка / обязательный	IP-адрес или имя хоста системы хранения данных.
api_token строка	Токен для работы с заблокированными ресурсами.
password строка	Пароль для аутентификации. Это обязательное поле.
username строка	Имя пользователя для аутентификации. Это обязательное поле.
spec словарь / обязательный	Спецификация задачи для группы Shadow Image.
copy_group_name строка / обязательный	Имя группы копирования; обязательно для всех операций. Требуется для задач разделения группы ShadowImage / повторной синхронизации группы ShadowImage / восстановления группы ShadowImage / удаления группы ShadowImage / переноса группы ShadowImage / отмены переноса группы ShadowImage.
copy_pace целое число	Укажите скорость копирования. Необязательный параметр для задач разделения группы ShadowImage / повторной синхронизации группы ShadowImage / восстановления группы ShadowImage.
force_delete логическое значение	Указывает, следует ли выполнить принудительное удаление. Требуется для задачи удаления группы ShadowImage. Варианты: `false` `true`
force_suspend логическое значение	Указывает, следует ли выполнить принудительную приостановку. Необязательный параметр для задачи разделения группы ShadowImage. Варианты: `false` `true`
primary_volume_device_group_name строка	Укажите имя группы устройств P-VOL.
quick_mode логическое значение	Указывает, следует ли использовать быстрый режим. Необязательный параметр для задач разделения группы ShadowImage / повторной синхронизации группы ShadowImage / восстановления группы ShadowImage. Варианты: `false` `true`
secondary_volume_device_group_name строка	Укажите имя группы устройств S-VOL.
should_force_split логическое значение	Указывает, следует ли выполнить принудительное разделение. Необязательный параметр для задачи отмены переноса группы ShadowImage. Варианты: `false` `true`
state строка	Уровень задачи для пар группы Shadow Image. Возможные варианты: `present`, `absent`, `split`, `sync`, `restore`, `migrate`. Варианты: `"present"` ← (по умолчанию) `"absent"` `"split"` `"resync"` `"sync"` `"restore"` `"migrate"`

Атрибуты

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

Примечания

Примечание

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

Примеры

- name: Split local copy group
  hitachivantara.vspone_block.vsp.hv_shadow_image_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: split
    spec:
      copy_group_name: remote_copy_group_copy_group_name_1
      primary_volume_device_group_name: remote_copy_group_local_device_group_name_1
      secondary_volume_device_group_name: remote_copy_group_remote_device_group_name_1
      quick_mode: true
      copy_pace: 100
      force_suspend: true

- name: Resync local copy group
  hitachivantara.vspone_block.vsp.hv_shadow_image_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: sync
    spec:
      copy_group_name: remote_copy_group_copy_group_name_1
      primary_volume_device_group_name: remote_copy_group_local_device_group_name_1
      secondary_volume_device_group_name: remote_copy_group_remote_device_group_name_1
      quick_mode: true
      copy_pace: 100

- name: Restore local copy group
  hitachivantara.vspone_block.vsp.hv_shadow_image_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: swap_split
    spec:
      copy_group_name: remote_copy_group_copy_group_name_1
      primary_volume_device_group_name: remote_copy_group_local_device_group_name_1
      secondary_volume_device_group_name: remote_copy_group_remote_device_group_name_1
      quick_mode: true
      copy_pace: 100

- name: Delete local copy group
  hitachivantara.vspone_block.vsp.hv_shadow_image_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: absent
    spec:
      copy_group_name: remote_copy_group_copy_group_name_1
      primary_volume_device_group_name: remote_copy_group_local_device_group_name_1
      secondary_volume_device_group_name: remote_copy_group_remote_device_group_name_1
      force_delete: true

- name: Migrate local copy group
  hitachivantara.vspone_block.vsp.hv_shadow_image_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: migrate
    spec:
      copy_group_name: remote_copy_group_copy_group_name_1

- name: Cancel migration of local copy group
  hitachivantara.vspone_block.vsp.hv_shadow_image_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    state: split
    spec:
      copy_group_name: remote_copy_group_copy_group_name_1
      should_force_split: true

Возвращаемые значения

Общие возвращаемые значения документированы здесь, ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
local_copy_group_info dictionary	Сведения о группе Shadow Image. Возвращается: при успехе
copy_group_name string	Имя группы копирования. Возвращается: при успехе Пример: `"SI172"`
copy_pairs list / elements=dictionary	Список пар копирования в группе копирования. Возвращается: при успехе
consistency_group_id string	Идентификатор группы согласованности. Возвращается: при успехе Пример: `""`
copy_group_name string	Имя группы копирования. Возвращается: при успехе Пример: `"SI172"`
copy_mode string	Режим копирования. Возвращается: при успехе Пример: `"NotSnapshot"`
copy_pair_name string	Имя пары копирования. Возвращается: при успехе Пример: `"CPTest"`
copy_progress_rate integer	Скорость выполнения копирования. Возвращается: при успехе Пример: `100`
local_clone_copypair_id string	Идентификатор пары копирования локального клонирования. Возвращается: при успехе Пример: `"SI172,SI172P_,SI172S_,CPTest"`
mirror_unit_number integer	Номер модуля зеркалирования. Возвращается: при успехе Пример: `0`
primary_volume_id integer	Идентификатор основного тома. Возвращается: при успехе Пример: `172`
primary_volume_status string	Состояние основного тома. Возвращается: при успехе Пример: `"PSUS"`
pvol_difference_data_management string	Устарело. Управление данными различий PVOL. Возвращается: при успехе Пример: `"S"`
pvol_ldev_id integer	Устарело. Вместо этого используйте primary_volume_id. Возвращается: при успехе Пример: `172`
pvol_mu_number integer	Устарело. Вместо этого используйте mirror_unit_number. Возвращается: при успехе Пример: `0`
pvol_processing_status string	Устарело. Состояние обработки PVOL. Возвращается: при успехе Пример: `"N"`
pvol_status string	Устарело. Вместо этого используйте primary_volume_status. Возвращается: при успехе Пример: `"PSUS"`
replication_type string	Тип репликации. Возвращается: при успехе Пример: `"SI"`
secondary_volume_id integer	Идентификатор вторичного тома. Возвращается: при успехе Пример: `173`
secondary_volume_status string	Состояние вторичного тома. Возвращается: при успехе Пример: `"SSUS"`
svol_difference_data_management string	Устарело. Управление данными различий SVOL. Возвращается: при успехе Пример: `"S"`
svol_ldev_id integer	Устарело. Вместо этого используйте secondary_volume_id. Возвращается: при успехе Пример: `173`
svol_processing_status string	Устарело. Состояние обработки SVOL. Возвращается: при успехе Пример: `"N"`
svol_status string	Устарело. Вместо этого используйте secondary_volume_status. Возвращается: при успехе Пример: `"SSUS"`
local_clone_copygroup_id string	Идентификатор группы копирования локального клонирования. Возвращается: при успехе Пример: `"SI172,SI172P_,SI172S_"`
primary_volume_device_group_name string	Имя группы устройств основного тома. Возвращается: при успехе Пример: `"SI172P_"`
pvol_device_group_name string	Устарело. Вместо этого используйте primary_volume_device_group_name. Возвращается: при успехе Пример: `"SI172P_"`
secondary_volume_device_group_name string	Имя группы устройств вторичного тома. Возвращается: при успехе Пример: `"SI172S_"`
svol_device_group_name string	Устарело. Вместо этого используйте secondary_volume_device_group_name. Возвращается: при успехе Пример: `"SI172S_"`

Авторы

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