Модуль 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. Если задано значение Если задано значение больше Если параметр не указан, по умолчанию используется значение По умолчанию: |
|
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 задано значение Этот параметр задает начальное смещение для последовательного извлечения; в результаты включаются все последующие 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 Пример: |
gad_pairs list / elements=dictionary | Список словарей с подробными свойствами пар GAD. Возвращается: success |
|
consistency_group_id integer |
Идентификатор группы согласованности, которой принадлежит пара. Возвращается: success Пример: |
|
copy_pace integer |
Скорость операции копирования (1–15). Возвращается: success Пример: |
|
copy_progress_rate integer |
Процент выполнения начального копирования. Возвращается: success Пример: |
|
copy_time integer |
Общее время в секундах до достижения состояния PAIR. Возвращается: success Пример: |
|
created_time string |
Метка времени создания пары. Возвращается: success Пример: |
|
data_synchronization_rate integer |
Процент синхронизации томов. Возвращается: success Пример: |
|
failure_factor string |
Причина сбоя пары GAD, если таковая имеется. Возвращается: success Пример: |
|
io_preference string |
Настройки предпочтений ввода-вывода. Возвращается: success Пример: |
|
local_last_updated_time string |
Метка времени последнего локального обновления. Возвращается: success Пример: |
|
mirror_unit_number integer |
Номер Mirror Unit (MU). Возвращается: success Пример: |
|
pair_operation_mode_for_blocked_quorum_disk string |
Поведение при блокировке диска кворума. Возвращается: success Пример: |
|
primary_volume_differential_data_management string |
Метод управления разностными данными. Возвращается: success Пример: |
|
primary_volume_id integer |
LDEV ID локального (основного) тома. Возвращается: success Пример: |
|
primary_volume_id_hex string |
Шестнадцатеричное представление идентификатора основного тома. Возвращается: success Пример: |
|
primary_volume_io_mode string |
Режим ввода-вывода узла (MIRROR, LOCAL, BLOCK). Возвращается: success Пример: |
|
primary_volume_name string |
Псевдоним или имя, присвоенное основному тому. Возвращается: success Пример: |
|
primary_volume_position string |
Роль локального тома (PRIMARY или SECONDARY). Возвращается: success Пример: |
|
primary_volume_processing_status string |
Состояние расширения емкости (IDLE, EXPANDING). Возвращается: success Пример: |
|
primary_volume_provisioning_type string |
Тип выделения ресурсов (INTERNAL, VIRTUAL или EXTERNAL). Возвращается: success Пример: |
|
primary_volume_status string |
Текущее состояние пары (PAIR, COPY, PSUS и т. д.). Возвращается: success Пример: |
|
quorum_disk_id integer |
Идентификатор диска кворума, используемого для пары GAD. Возвращается: success Пример: |
|
remote_connection_id dictionary |
Информация о подключении к удаленной системе хранения. Возвращается: success |
|
path_group_id integer |
Идентификатор группы путей, используемой для подключения. Возвращается: success Пример: |
|
storage_model string |
Модель удаленной системы хранения (например, RH20ETP). Возвращается: success Пример: |
|
storage_serial_number string |
Серийный номер удаленной системы хранения. Возвращается: success Пример: |
|
secondary_volume_id integer |
LDEV ID тома в удаленной системе хранения. Возвращается: success Пример: |
|
secondary_volume_id_hex string |
Шестнадцатеричное представление идентификатора вторичного тома. Возвращается: success Пример: |
Ссылки на коллекцию
© 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