hitachivantara.vspone_block.vsp.hv_vsp_one_gad_facts module – Retrieves GAD (Global-Active Device) information from VSP One storage systems.

Synopsis

• This module retrieves GAD pair information from VSP One Block 20/80 series and VSP E series storage systems.

Parameters

Examples

# ######################################################################################
# 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

Returned Facts

Facts returned by this module are added/updated in the hostvars host facts and can be referenced by name just like any other host fact. They do not need to be registered in order to use them.