Spec-Zone.ru › Ansible

Модуль hitachivantara.vspone_block.vsp.hv_vsp_one_gad_facts – извлекает информацию о GAD (Global-Active Device) из систем хранения VSP One.

Примечание

Этот модуль входит в коллекцию 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_vsp_one_gad_facts.

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

  • Краткое описание
  • Параметры
  • Примеры
  • Возвращаемые факты

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

  • Этот модуль извлекает информацию о парах GAD из систем хранения VSP One Block серий 20/80 и VSP E.

Параметры

Параметр

Комментарии

connection_info

dictionary / обязательный

Информация, необходимая для подключения к системе хранения.

address

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

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

api_token

string

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

password

string

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

username

string

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

spec

dictionary

Параметры запроса для фильтрации и постраничного вывода информации о парах GAD.

consistency_group_id

integer

Фильтровать результаты по указанному идентификатору группы согласованности.

Если параметр не указан, извлекаются пары GAD из всех групп согласованности.

count

integer

Максимальное количество записей о парах GAD, извлекаемых за одну операцию.

Поддерживаются значения от 1 до 500.

Если задано значение 1 вместе с primary_volume_id, модуль выбирает определенную пару GAD, соответствующую этому LDEV ID и Mirror Unit.

Если задано значение больше 1, запускается последовательное извлечение. Оно начинается с указанного курсора (или со следующей по номеру доступной пары, если точный идентификатор отсутствует) и включает все последующие записи для всех Mirror Unit.

Если параметр не указан, по умолчанию используется значение 500: извлекается до 500 пар, начиная с начала списка или с указанного primary_volume_id.

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

mirror_unit_number

integer

Номер Mirror Unit (MU), связанный с primary_volume_id, с которого следует начать извлечение.

Если указан primary_volume_id, но этот параметр не задан, по умолчанию используется значение 0.

В результаты будут включены все последующие пары независимо от номера Mirror Unit.

primary_volume_id

integer

Задает начальный LDEV ID для постраничного вывода на основе курсора.

Если параметр указан, извлечение начинается с этого идентификатора тома. Если точный LDEV ID отсутствует, операция переходит к следующей доступной паре.

Если для count задано значение 1, этот параметр используется для поиска указанного LDEV.

Этот параметр задает начальное смещение для последовательного извлечения; в результаты включаются все последующие LDEV в пределах указанного значения count.

Примеры

# ######################################################################################
# Task: Retrieve GAD pairs using the default batch size (500) from the beginning of the list.
# ######################################################################################
- name: Get all GAD pairs (default limit)
  hitachivantara.vspone_block.vsp.hv_vsp_one_gad_facts:
    connection_info: "{{ connection_info }}"
  register: result

- name: Debug the result variable
  ansible.builtin.debug:
    var: result

# ######################################################################################
# Task: Retrieve a specific number of GAD pairs from the beginning of the list.
# ######################################################################################
- name: Get first 10 GAD pairs
  hitachivantara.vspone_block.vsp.hv_vsp_one_gad_facts:
    connection_info: "{{ connection_info }}"
    spec:
      count: 10
  register: result

- name: Debug the result variable
  ansible.builtin.debug:
    var: result

# ######################################################################################
# Task: Retrieve first available gad pair.
# ######################################################################################
- name: Get first available GAD pair
  hitachivantara.vspone_block.vsp.hv_vsp_one_gad_facts:
    connection_info: "{{ connection_info }}"
    spec:
      count: 1
  register: result

- name: Debug the result variable
  ansible.builtin.debug:
    var: result

# ######################################################################################
# Task: Filter GAD pairs by Consistency Group ID.
# Returns an empty list if no pairs are associated with the specified group.
# ######################################################################################
- name: Get GAD pairs for Consistency Group 2
  hitachivantara.vspone_block.vsp.hv_vsp_one_gad_facts:
    connection_info: "{{ connection_info }}"
    spec:
      consistency_group_id: 2
  register: result

- name: Debug the result variable
  ansible.builtin.debug:
    var: result

# ######################################################################################
# Task: Retrieve a single GAD pair from a specific Consistency Group.
# ######################################################################################
- name: Get a single GAD pair from Consistency Group 2
  hitachivantara.vspone_block.vsp.hv_vsp_one_gad_facts:
    connection_info: "{{ connection_info }}"
    spec:
      consistency_group_id: 2
      count: 1
  register: result

# ######################################################################################
# Task: Retrieve information for a specific LDEV and Mirror Unit.
# Set count to 1 to find only this specific GAD pair LDEVID/MU.
# ######################################################################################
- name: Get specific GAD pair by LDEV and MU
  hitachivantara.vspone_block.vsp.hv_vsp_one_gad_facts:
    connection_info: "{{ connection_info }}"
    spec:
      primary_volume_id: 244
      mirror_unit_number: 3
      count: 1
  register: result

- name: Debug the result variable
  ansible.builtin.debug:
    var: result

# ######################################################################################
# Task: Retrieve specific GAD pair using the default Mirror Unit (0).
# Set count to 1 to find only this specific GAD pair LDEVID/MU.
# ######################################################################################
- name: Get GAD pair by LDEV ID (Default MU 0)
  hitachivantara.vspone_block.vsp.hv_vsp_one_gad_facts:
    connection_info: "{{ connection_info }}"
    spec:
      primary_volume_id: 244
      count: 1
  register: result

# ######################################################################################
# Task: Cursor-based batch retrieval.
# Starts at LDEV 249 / MU 3 if present; otherwise, falls back to the next available
# pair in numerical order. Results include all subsequent Mirror Units and volumes.
# ######################################################################################
- name: Get batch of 10 pairs starting from a gad pair
  hitachivantara.vspone_block.vsp.hv_vsp_one_gad_facts:
    connection_info: "{{ connection_info }}"
    spec:
      primary_volume_id: 249
      mirror_unit_number: 3
      count: 10
  register: result

- name: Debug the result variable
  ansible.builtin.debug:
    var: result

# ######################################################################################
# Task: Sequential retrieval starting from a volume-level cursor.
# Defaults to Mirror Unit 0. Retrieval starts from the specified ID or the next
# available numerical match up to the maximum batch limit (500).
# ######################################################################################
- name: Get up to 500 pairs starting from Volume 249
  hitachivantara.vspone_block.vsp.hv_vsp_one_gad_facts:
    connection_info: "{{ connection_info }}"
    spec:
      primary_volume_id: 249
  register: result

- name: Debug the result variable
  ansible.builtin.debug:
    var: result

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

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

Ключ

Описание

count

integer

Количество пар GAD, извлеченных и сохраненных в ansible_facts.

Возвращается: success

Пример: 2

gad_pairs

list / elements=dictionary

Список словарей с подробными свойствами пар GAD.

Возвращается: success

consistency_group_id

integer

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

Возвращается: success

Пример: 2

copy_pace

integer

Скорость операции копирования (1–15).

Возвращается: success

Пример: 3

copy_progress_rate

integer

Процент выполнения начального копирования.

Возвращается: success

Пример: -1

copy_time

integer

Общее время в секундах до достижения состояния PAIR.

Возвращается: success

Пример: 0

created_time

string

Метка времени создания пары.

Возвращается: success

Пример: "2024-10-01T10:00:00Z"

data_synchronization_rate

integer

Процент синхронизации томов.

Возвращается: success

Пример: 100

failure_factor

string

Причина сбоя пары GAD, если таковая имеется.

Возвращается: success

Пример: "NONE"

io_preference

string

Настройки предпочтений ввода-вывода.

Возвращается: success

Пример: "DISABLED"

local_last_updated_time

string

Метка времени последнего локального обновления.

Возвращается: success

Пример: "2024-10-01T10:05:00Z"

mirror_unit_number

integer

Номер Mirror Unit (MU).

Возвращается: success

Пример: 0

pair_operation_mode_for_blocked_quorum_disk

string

Поведение при блокировке диска кворума.

Возвращается: success

Пример: "QUORUMLESS"

primary_volume_differential_data_management

string

Метод управления разностными данными.

Возвращается: success

Пример: "HIERARCHICAL"

primary_volume_id

integer

LDEV ID локального (основного) тома.

Возвращается: success

Пример: 244

primary_volume_id_hex

string

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

Возвращается: success

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

primary_volume_io_mode

string

Режим ввода-вывода узла (MIRROR, LOCAL, BLOCK).

Возвращается: success

Пример: "MIRROR"

primary_volume_name

string

Псевдоним или имя, присвоенное основному тому.

Возвращается: success

Пример: "GadTest"

primary_volume_position

string

Роль локального тома (PRIMARY или SECONDARY).

Возвращается: success

Пример: "PRIMARY"

primary_volume_processing_status

string

Состояние расширения емкости (IDLE, EXPANDING).

Возвращается: success

Пример: "IDLE"

primary_volume_provisioning_type

string

Тип выделения ресурсов (INTERNAL, VIRTUAL или EXTERNAL).

Возвращается: success

Пример: "VIRTUAL"

primary_volume_status

string

Текущее состояние пары (PAIR, COPY, PSUS и т. д.).

Возвращается: success

Пример: "PAIR"

quorum_disk_id

integer

Идентификатор диска кворума, используемого для пары GAD.

Возвращается: success

Пример: 22

remote_connection_id

dictionary

Информация о подключении к удаленной системе хранения.

Возвращается: success

path_group_id

integer

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

Возвращается: success

Пример: 0

storage_model

string

Модель удаленной системы хранения (например, RH20ETP).

Возвращается: success

Пример: "RH20ETP"

storage_serial_number

string

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

Возвращается: success

Пример: "70041"

secondary_volume_id

integer

LDEV ID тома в удаленной системе хранения.

Возвращается: success

Пример: 55

secondary_volume_id_hex

string

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

Возвращается: success

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

Авторы

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

Spec-Zone.ru

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