Spec-Zone.ru › Ansible

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

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

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

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

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

Требования

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

  • python >= 3.9

Параметры

Параметр

Комментарии

connection_info

словарь / обязательный

Сведения, необходимые для установления соединения с системой хранения.

address

строка / обязательный

IP-адрес или имя узла системы хранения.

api_token

строка

Токен для работы с заблокированными ресурсами.

connection_type

строка

Тип соединения с системой хранения.

Варианты:

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

password

строка

Пароль для аутентификации. Это обязательное поле.

username

строка

Имя пользователя для аутентификации. Это обязательное поле.

spec

словарь

Спецификация данных о снимках, которые необходимо собрать.

mirror_unit_number

псевдонимы: mirror_unit_id

целое число

Идентификатор модуля зеркалирования. Если не указан, он будет пропущен. Обязателен для задачи получения одной пары снимков.

primary_volume_id

строка

Идентификатор основного тома. Если не указан, он будет пропущен. Обязателен для задач получения пар снимков с одинаковым P-VOL и получения одной пары снимков.

storage_system_info

словарь

Сведения о системе хранения. Это поле необязательное.

serial

строка

Серийный номер системы хранения.

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: полная

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

Примечания

Примечание

  • Тип соединения gateway удалён начиная с версии 3.4.0. Если вам необходим этот тип соединения, используйте более раннюю версию.
  • В настоящее время извлекаются только пары, принадлежащие группе копирования. Поэтому рекомендуется удалить все существующие пары, не входящие в группу копирования, и повторно создать пары репликации, используя прямое подключение с технологией групп копирования.

Примеры

- name: Gather snapshot facts with primary volume and mirror unit ID
  hitachivantara.vspone_block.vsp.hv_snapshot_facts:
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      primary_volume_id: 525
      mirror_unit_number: 10

- name: Gather snapshot facts with only primary volume
  hitachivantara.vspone_block.vsp.hv_snapshot_facts:
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      primary_volume_id: 'volume1'

- name: Gather snapshot facts without specific volume or mirror unit ID
  hitachivantara.vspone_block.vsp.hv_snapshot_facts:
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"

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

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

Ключ

Описание

snapshots

list / elements=dictionary

Список снимков, полученных из системы хранения данных.

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

can_cascade

boolean

Указывает, может ли снимок быть каскадным.

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

Пример: true

concordance_rate

integer

Степень согласованности снимка.

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

Пример: -1

copy_pace_track_size

string

Устарело. Размер дорожки для скорости копирования.

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

Пример: ""

copy_rate

integer

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

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

Пример: -1

is_clone

boolean

Указывает, является ли снимок клоном.

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

Пример: false

is_cloned

boolean

Устарело. Указывает, был ли снимок клонирован.

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

Пример: false

is_consistency_group

boolean

Указывает, входит ли снимок в группу согласованности.

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

Пример: true

is_data_reduction_force_copy

boolean

Указывает, включено ли принудительное копирование с сокращением объема данных.

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

Пример: true

is_redirect_on_write

boolean

Указывает, включен ли режим перенаправления при записи.

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

Пример: true

is_snapshot_data_read_only

boolean

Устарело. Указывает, доступны ли данные снимка только для чтения.

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

is_virtual_clone_parent_volume

boolean

Указывает, является ли этот том родительским томом виртуального клона.

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

Пример: false

is_virtual_clone_volume

boolean

Указывает, является ли этот том томом виртуального клона.

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

Пример: false

is_written_in_secondary_volume

boolean

Указывает, записываются ли данные во вторичный том.

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

Пример: false

is_written_in_svol

boolean

Устарело. Вместо этого используйте is_written_in_secondary_volume.

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

Пример: false

mirror_unit_id

integer

Устарело. Вместо этого используйте mirror_unit_number. Идентификатор блока зеркалирования.

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

Пример: 0

mirror_unit_number

integer

Идентификатор блока зеркалирования.

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

Пример: 3

pool_id

integer

Идентификатор пула.

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

Пример: 1

primary_volume_host_groups

list / elements=string

Список групп узлов для первичного тома.

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

Пример: []

primary_volume_id

integer

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

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

Пример: 168

primary_volume_id_hex

string

Шестнадцатеричный идентификатор первичного тома.

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

Пример: "00:00:A8"

primary_volume_nvm_subsystem_name

string

Имя подсистемы NVM для первичного тома.

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

Пример: ""

primary_volume_processing_status

string

Состояние обработки первичного тома.

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

Пример: "N"

progress_rate

integer

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

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

Пример: -1

pvol_host_groups

list / elements=string

Устарело. Вместо этого используйте primary_volume_host_groups.

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

Пример: []

pvol_nvm_subsystem_name

string

Устарело. Вместо этого используйте primary_volume_nvm_subsystem_name.

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

Пример: ""

pvol_processing_status

string

Устарело. Вместо этого используйте primary_volume_processing_status.

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

Пример: "N"

retention_period_in_hours

integer

Срок хранения снимка в часах.

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

Пример: -1

secondary_volume_host_groups

list / elements=string

Список групп узлов для вторичного тома.

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

Пример: []

secondary_volume_id

integer

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

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

Пример: 205

secondary_volume_id_hex

string

Шестнадцатеричный идентификатор вторичного тома.

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

Пример: "00:00:CD"

secondary_volume_nvm_subsystem_name

string

Имя подсистемы NVM для вторичного тома.

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

Пример: ""

secondary_volume_processing_status

string

Состояние обработки вторичного тома.

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

Пример: "N"

snapshot_group_name

string

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

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

Пример: "snewar-tia-grp-02"

snapshot_id

string

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

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

Пример: "168,3"

split_time

string

Время разделения снимка.

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

Пример: ""

status

string

Состояние снимка.

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

Пример: "PFUL"

svol_host_groups

list / elements=string

Устарело. Вместо этого используйте secondary_volume_host_groups.

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

Пример: []

svol_nvm_subsystem_name

string

Устарело. Вместо этого используйте secondary_volume_nvm_subsystem_name.

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

Пример: ""

svol_processing_status

string

Устарело. Вместо этого используйте secondary_volume_processing_status.

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

Пример: ""

type

string

Тип снимка.

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

Пример: "CASCADE"

Авторы

  • 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_snapshot_facts_module.html

Spec-Zone.ru

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