Spec-Zone.ru › Ansible

Модуль 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

Тип подключения к системе хранения данных.

Варианты:

  • "direct" ← (по умолчанию)

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.

По умолчанию: 3

copy_pair_base_name

string / обязательно

Префикс имен пар копирования. Фактические имена пар копирования будут иметь вид <copy_pair_base_name>_<primary_volume_id>_<secondary_volume_id>

data_reduction_share

boolean

Указывает, следует ли создать общий том с сокращением объема данных. Для Thin Image Advance это значение установлено в true.

Варианты:

  • false
  • true

do_initial_copy

boolean

Выполнить первоначальное копирование. Это необязательное поле при операции создания.

Варианты:

  • false
  • true ← (по умолчанию)

end_primary_volume_id

string

Конечный идентификатор первичного тома для пакетного создания с использованием существующих томов.

end_secondary_volume_id

string

Конечный идентификатор LDEV для диапазона вторичных томов.

fence_level

string

Задает уровень блокировки первичного тома и определяет, будет ли хост лишен доступа к первичному тому или сможет продолжить доступ к нему при приостановке пары из-за ошибки. Это необязательное поле.

Варианты:

  • "NEVER" ← (по умолчанию)
  • "DATA"
  • "STATUS"

is_consistency_group

boolean

Это необязательное поле при операции создания. В зависимости от значения этот атрибут указывает, следует ли зарегистрировать новую пару в группе согласованности. Если значение равно true, новая пара регистрируется в группе согласованности. Если значение равно false, новая пара не регистрируется в группе согласованности.

Варианты:

  • false ← (по умолчанию)
  • true

is_data_reduction_force_copy

boolean

Принудительное копирование для сокращения объема данных. Это необязательное поле при операции создания.

Варианты:

  • false
  • true ← (по умолчанию)

is_new_group_creation

boolean

Создать новую группу копирования. Это необязательное поле при операции создания.

Варианты:

  • false
  • true

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

Количество цифр в суффиксе имен первичных томов при массовом создании.

Варианты:

  • 1
  • 2
  • 3
  • 4
  • 5

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

Установите значение present, чтобы создать пары HUR массово.

Варианты:

  • "present" ← (по умолчанию)

Атрибуты

Атрибут

Поддержка

Описание

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

Идентификатор группы согласованности.

Возвращается: при успешном выполнении

Пример: -1

copy_group_name

string

Имя группы копирования.

Возвращается: при успешном выполнении

Пример: "ESD_TC_CG"

copy_pair_name

string

Имя пары копирования.

Возвращается: при успешном выполнении

Пример: "ESD_TC_CP"

copy_progress_rate

integer

Устарело. Скорость выполнения копирования.

Возвращается: при успешном выполнении

Пример: -1

fence_level

string

Уровень ограждения.

Возвращается: при успешном выполнении

Пример: "NEVER"

local_device_group_name

string

Имя локальной группы устройств, для которой нужно получить сведения о паре TrueCopy.

Возвращается: при успешном выполнении

Пример: "tc_bulk_cg_1P_"

primary_volume_id

integer

Идентификатор основного тома.

Возвращается: при успешном выполнении

Пример: 11

primary_volume_id_hex

string

Идентификатор основного тома в шестнадцатеричном формате.

Возвращается: при успешном выполнении

Пример: "00:00:0B"

primary_volume_size

string

Размер основного тома.

Возвращается: при успешном выполнении

Пример: "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.

Возвращается: при успешном выполнении

Пример: "A00000970041"

remote_device_group_name

string

Имя удалённой группы устройств, для которой нужно получить сведения о паре TrueCopy.

Возвращается: при успешном выполнении

Пример: "tc_bulk_cg_1S_"

remote_mirror_copy_pair_id

string

Идентификатор пары копирования удалённого зеркала.

Возвращается: при успешном выполнении

Пример: "A00000970045,ESD_TC_CG,ESD_TC_CGP_,ESD_TC_CGS_,ESD_TC_CP"

secondary_volume_id

integer

Идентификатор вторичного тома.

Возвращается: при успешном выполнении

Пример: 11

secondary_volume_id_hex

string

Идентификатор вторичного тома в шестнадцатеричном формате.

Возвращается: при успешном выполнении

Пример: "00:00:0B"

secondary_volume_size

string

Размер вторичного тома.

Возвращается: при успешном выполнении

Пример: "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_bulk_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API