Модуль hitachivantara.vspone_block.vsp.hv_truecopy_bulk — управление группами пар 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_bulk.
Добавлено в hitachivantara.vspone_block 4.7.0
Краткое описание
- Этот модуль позволяет массово создавать пары TrueCopy в блочных системах хранения VSP
- Обеспечивает эффективное создание нескольких пар TrueCopy за одну операцию.
- Примеры см. по адресу https://github.com/hitachi-vantara/vspone-block-ansible/blob/main/playbooks/vsp_direct/truecopy_bulk.yml
Требования
Следующие требования должны быть выполнены на узле, выполняющем этот модуль.
- python >= 3.9
Параметры
Параметр | Комментарии |
|---|---|
connection_info dictionary / обязательно | Информация, необходимая для установления подключения к системе хранения данных. |
|
address string / обязательно |
IP-адрес или имя хоста системы хранения данных. |
|
api_token string |
Токен для работы с заблокированными ресурсами. |
|
connection_type string |
Тип подключения к системе хранения данных. Варианты:
|
|
password string |
Пароль для аутентификации. Это обязательное поле. |
|
username string |
Имя пользователя для аутентификации. Это обязательное поле. |
secondary_connection_info dictionary | Информация, необходимая для установления подключения к вторичной системе хранения данных. |
|
address string / обязательно |
IP-адрес или имя хоста системы хранения данных Hitachi. |
|
api_token string |
Это поле используется для передачи значения токена блокировки вторичной системы хранения данных, чтобы работать с заблокированными ресурсами. |
|
password string |
Пароль для аутентификации. Это обязательное поле, если не указан api_token. |
|
username string |
Имя пользователя для аутентификации. Это обязательное поле, если не указан api_token. |
spec dictionary / обязательно | Спецификация задачи массового создания пар TrueCopy. |
|
begin_primary_volume_id string |
Начальный идентификатор первичного тома для пакетного создания с использованием существующих томов. |
|
begin_secondary_volume_id string |
Начальный идентификатор LDEV для диапазона вторичных томов. |
|
capacity_saving string |
Режим экономии емкости для новых томов (например, ‘compression’, ‘deduplication_compression’). |
|
consistency_group_id integer |
Идентификатор группы согласованности от 0 до 255. Это необязательное поле. |
|
copy_group_name string / обязательно |
Имя группы копирования. |
|
copy_pace integer |
Скорость копирования для пары GAD. Поддерживаются значения от 1 до 15. По умолчанию: |
|
copy_pair_base_name string / обязательно |
Префикс имен пар копирования. Фактические имена пар копирования будут иметь вид <copy_pair_base_name>_<primary_volume_id>_<secondary_volume_id> |
|
boolean |
Указывает, следует ли создать общий том с сокращением объема данных. Для Thin Image Advance это значение установлено в true. Варианты:
|
|
do_initial_copy boolean |
Выполнить первоначальное копирование. Это необязательное поле при операции создания. Варианты:
|
|
end_primary_volume_id string |
Конечный идентификатор первичного тома для пакетного создания с использованием существующих томов. |
|
end_secondary_volume_id string |
Конечный идентификатор LDEV для диапазона вторичных томов. |
|
fence_level string |
Задает уровень блокировки первичного тома и определяет, будет ли хост лишен доступа к первичному тому или сможет продолжить доступ к нему при приостановке пары из-за ошибки. Это необязательное поле. Варианты:
|
|
is_consistency_group boolean |
Это необязательное поле при операции создания. В зависимости от значения этот атрибут указывает, следует ли зарегистрировать новую пару в группе согласованности. Если значение равно true, новая пара регистрируется в группе согласованности. Если значение равно false, новая пара не регистрируется в группе согласованности. Варианты:
|
|
is_data_reduction_force_copy boolean |
Принудительное копирование для сокращения объема данных. Это необязательное поле при операции создания. Варианты:
|
|
is_new_group_creation boolean |
Создать новую группу копирования. Это необязательное поле при операции создания. Варианты:
|
|
local_device_group_name string |
Имя локальной группы устройств. Это необязательное поле. |
|
number_of_pairs integer / обязательно |
Количество пар GAD для пакетного создания. |
|
path_group_id integer |
Это необязательное поле при операции создания. Укажите идентификатор группы путей в диапазоне от 0 до 255. Если вы не уверены, не используйте этот параметр. Если опустить это значение или указать 0, будет использован наименьший идентификатор группы путей в указанной группе путей. |
|
primary_hostgroups list / elements=dictionary |
Список объектов групп хостов для первичных томов. |
|
lun_id integer |
Идентификатор LUN группы хостов во вторичной системе хранения данных. Не требуется для операции создания. |
|
name string / обязательно |
Имя группы хостов во вторичной системе хранения данных. Требуется для операции создания. |
|
port_id string / обязательно |
Порт группы хостов во вторичной системе хранения данных. Требуется для операции создания. |
|
primary_iscsi_targets list / elements=dictionary |
Список целей iSCSI на первичном устройстве хранения данных. |
|
lun_id integer |
Идентификатор LUN. |
|
name string / обязательно |
Имя цели iSCSI. |
|
port_id string / обязательно |
Идентификатор порта. |
|
primary_nvm_subsystem dictionary |
Сведения о подсистеме NVM первичного тома.. |
|
name string / обязательно |
Имя подсистемы NVM в первичной системе хранения данных. |
|
paths list / elements=string |
Сведения о путях Host NQN в первичной системе хранения данных. |
|
primary_pool_id integer / обязательно |
Идентификатор динамического пула, в котором будут созданы первичные тома. |
|
primary_volume_base_name string |
Префикс имен первичных томов при массовом создании новых томов. |
|
primary_volume_base_name_number_of_digits integer |
Количество цифр в суффиксе имен первичных томов при массовом создании. Варианты:
|
|
primary_volume_base_name_start_number integer |
Начальное число, которое будет добавлено к primary_volume_base_name для формирования имени первого тома при массовом создании. |
|
remote_device_group_name string |
Имя удаленной группы устройств. Это необязательное поле. |
|
secondary_hostgroups list / elements=dictionary |
Список объектов групп хостов для вторичных томов. |
|
lun_id integer |
Идентификатор LUN группы хостов во вторичной системе хранения данных. Не требуется для операции создания. |
|
name string / обязательно |
Имя группы хостов во вторичной системе хранения данных. Требуется для операции создания. |
|
port_id string / обязательно |
Порт группы хостов во вторичной системе хранения данных. Требуется для операции создания. |
|
secondary_iscsi_targets list / elements=dictionary |
Список целей iSCSI на вторичном устройстве хранения данных. |
|
lun_id integer |
Идентификатор LUN. |
|
name string / обязательно |
Имя цели iSCSI для вторичной системы хранения данных. |
|
port_id string / обязательно |
Идентификатор порта. |
|
secondary_nvm_subsystem dictionary |
Сведения о подсистеме NVM вторичного тома. |
|
name string / обязательно |
Имя подсистемы NVM во вторичной системе хранения данных. |
|
paths list / elements=string |
Сведения о путях Host NQN во вторичной системе хранения данных. |
|
secondary_pool_id integer / обязательно |
Идентификатор динамического пула, в котором будут созданы вторичные тома. |
|
volume_size string / обязательно |
Размер создаваемых томов (например, ‘10GB’, ‘1TB’) для создания пар TrueCopy. |
state string | Установите значение Варианты:
|
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: отсутствует | Определяет, должен ли модуль выполняться в режиме проверки. |
Примеры
- name: Create a TrueCopy pairs in bulk mode
hitachivantara.vspone_block.vsp.hv_truecopy_bulk:
connection_info:
address: storage1.company.com
username: "admin"
password: "secret"
secondary_connection_info:
address: storage2.company.com
username: "admin"
password: "secret"
spec:
number_of_pairs: 2
copy_group_name: "rd_tc_cg_123"
copy_pair_base_name: "rd_tc_cp_123_"
primary_pool_id: 0
secondary_pool_id: 0
volume_size: "1GB"
primary_hostgroups:
- name: "snewar-common-hg-01"
port_id: "CL2-A"
- name: "snewar-common-hg-01"
port_id: "CL2-B"
secondary_hostgroups:
- name: "snewar-common-hg-01"
port_id: "CL2-A"
- name: "snewar-common-hg-01"
port_id: "CL2-B"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
truecopy_info list / elements=dictionary | Список объектов пар TrueCopy, возвращаемых модулем. Возвращается: при успешном выполнении |
|
consistency_group_id integer |
Идентификатор группы согласованности. Возвращается: при успешном выполнении Пример: |
|
copy_group_name string |
Имя группы копирования. Возвращается: при успешном выполнении Пример: |
|
copy_pair_name string |
Имя пары копирования. Возвращается: при успешном выполнении Пример: |
|
copy_progress_rate integer |
Устарело. Скорость выполнения копирования. Возвращается: при успешном выполнении Пример: |
|
fence_level string |
Уровень ограждения. Возвращается: при успешном выполнении Пример: |
|
local_device_group_name string |
Имя локальной группы устройств, для которой нужно получить сведения о паре TrueCopy. Возвращается: при успешном выполнении Пример: |
|
primary_volume_id integer |
Идентификатор основного тома. Возвращается: при успешном выполнении Пример: |
|
primary_volume_id_hex string |
Идентификатор основного тома в шестнадцатеричном формате. Возвращается: при успешном выполнении Пример: |
|
primary_volume_size string |
Размер основного тома. Возвращается: при успешном выполнении Пример: |
|
primary_volume_status string |
Состояние основного тома. Возвращается: при успешном выполнении Пример: |
|
primary_volume_storage_serial_number string |
Серийный номер хранилища основного тома. Возвращается: при успешном выполнении Пример: |
|
pvol_status string |
Устарело. Используйте вместо этого primary_volume_status. Возвращается: при успешном выполнении Пример: |
|
pvol_storage_device_id string |
Устарело. Идентификатор устройства хранения PVOL. Возвращается: при успешном выполнении Пример: |
|
remote_device_group_name string |
Имя удалённой группы устройств, для которой нужно получить сведения о паре TrueCopy. Возвращается: при успешном выполнении Пример: |
|
remote_mirror_copy_pair_id string |
Идентификатор пары копирования удалённого зеркала. Возвращается: при успешном выполнении Пример: |
|
secondary_volume_id integer |
Идентификатор вторичного тома. Возвращается: при успешном выполнении Пример: |
|
secondary_volume_id_hex string |
Идентификатор вторичного тома в шестнадцатеричном формате. Возвращается: при успешном выполнении Пример: |
|
secondary_volume_size string |
Размер вторичного тома. Возвращается: при успешном выполнении Пример: |
|
secondary_volume_status string |
Состояние вторичного тома. Возвращается: при успешном выполнении Пример: |
|
secondary_volume_storage_serial_number string |
Серийный номер хранилища вторичного тома. Возвращается: при успешном выполнении Пример: |
|
storage_serial_number string |
Устарело. Используйте вместо этого primary_volume_storage_serial_number. Возвращается: при успешном выполнении Пример: |
|
svol_status string |
Устарело. Используйте вместо этого secondary_volume_status. Возвращается: при успешном выполнении Пример: |
|
svol_storage_device_id string |
Устарело. Идентификатор устройства хранения SVOL. Возвращается: при успешном выполнении Пример: |
Ссылки коллекции
© 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_bulk_module.html