Spec-Zone.ru › Ansible

Модуль hitachivantara.vspone_block.vsp.hv_ldev_facts — извлекает информацию о логических устройствах (LDEV) из систем хранения данных VSP Block.

Примечание

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

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

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

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

  • Этот модуль извлекает информацию о логических устройствах (LDEV) из систем хранения данных VSP Block.
  • Он предоставляет такие сведения, как идентификаторы и имена LDEV, а также другую важную информацию.
  • Примеры см. по адресу https://github.com/hitachi-vantara/vspone-block-ansible/blob/main/playbooks/vsp_direct/ldev_facts.yml

Требования

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

  • python >= 3.9

Параметры

Параметр

Комментарии

connection_info

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

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

address

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

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

api_token

string

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

connection_type

string

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

Варианты:

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

password

string

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

username

string

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

spec

dictionary

Параметры для извлечения информации о LDEV.

count

integer

Количество извлекаемых LDEV. Обязательный параметр для задачи Get LDEVs from start ID up to max count. Необязательный параметр для задачи Get Free LDEV IDs.

end_ldev_id

string

Конечный идентификатор LDEV для фильтрации LDEV. Может быть десятичным или шестнадцатеричным. Обязательный параметр для задачи Get LDEVs within range. Необязательный параметр для задачи Get Free LDEV IDs.

is_detailed

boolean

Флаг для извлечения всех дополнительных свойств, которые не возвращаются в обычном выводе фактов LDEV. Обязательный параметр для задачи Get one LDEV with detailed info.

Варианты:

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

journal_id

integer

Идентификатор журнала для фильтрации LDEV. Обязательный параметр для задачи Get LDEV details using journal ID.

ldev_id

string

Идентификатор конкретного LDEV, сведения о котором требуется извлечь. Может быть десятичным или шестнадцатеричным. Обязательный параметр для задач Get one LDEV /Get one LDEV with detailed info /Get one ldev with detailed info by specifying one or more query parameters.

ldev_ids

list / elements=string

Список идентификаторов LDEV, сведения о которых требуется извлечь. Идентификаторы могут быть десятичными или шестнадцатеричными. Обязательный параметр для задачи Get multiple LDEVs.

name

string

Имя LDEV. Обязательный параметр для задачи Get LDEVs with the same name.

parity_group_id

string

Идентификатор группы четности для фильтрации LDEV. Обязательный параметр для задачи Get LDEV details using parity group ID.

pool_id

integer

Идентификатор пула для фильтрации LDEV. Обязательный параметр для задачи Get LDEV details using pool ID.

query

list / elements=string

Получение всех дополнительных свойств в выводе фактов LDEV занимает много времени. Для повышения производительности можно указать список дополнительных свойств, которые нужно извлечь. Это поле позволяет задать список строк, каждая из которых указывает, какие дополнительные свойства следует извлечь. Если для is_detailed задано значение true, это поле игнорируется, и извлекаются все дополнительные свойства. Поддерживаются следующие дополнительные свойства: “cmd_device_settings”, “encryption_settings”, “nvm_subsystem_info”, “qos_settings”, “free_ldev_id” и “snapshots_info”. Обязательный параметр для задач Get one ldev with detailed info by specifying one or more query parameters /Get Free LDEV IDs.

resource_group_id

integer

Идентификатор группы ресурсов для фильтрации LDEV. Обязательный параметр для задачи Get LDEV details using resource group ID.

start_ldev_id

string

Начальный идентификатор LDEV для фильтрации LDEV. Может быть десятичным или шестнадцатеричным. Обязательный параметр для задач Get LDEVs within range /Get LDEVs from start ID up to max count. Необязательный параметр для задачи Get Free LDEV IDs.

storage_system_info

dictionary

Информация о системе хранения данных. Это необязательное поле.

serial

string

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

Атрибуты

Атрибут

Поддержка

Описание

check_mode

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

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

Примечания

Примечание

  • Тип подключения gateway удален начиная с версии 3.4.0. Если вам требуется этот тип подключения, используйте более раннюю версию.

Примеры

- name: Get all ldevs
  hitachivantara.vspone_block.vsp.hv_ldev_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"

- name: Retrieve information about a specific LDEV
  hitachivantara.vspone_block.vsp.hv_ldev_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    spec:
      ldev_id: 123

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

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

Ключ

Описание

free_ldev_ids

list / elements=integer

Список свободных идентификаторов LDEV при запросе доступных LDEV.

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

Пример: [100, 101, 102, 103, 104]

volumes

list / elements=dictionary

Список томов хранилища с их атрибутами.

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

canonical_name

string

Уникальный идентификатор тома.

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

Пример: "naa.60060e8028273d005080273d00000102"

clpr_id

integer

Идентификатор CLPR (логического раздела управления).

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

Пример: 0

compression_acceleration_status

string

Состояние ускорителя сжатия.

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

Пример: "ENABLED"

cylinder

integer

Номер цилиндра для мейнфрейм-томов.

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

Пример: 65945

data_reduction_process_mode

string

Режим процесса сокращения объема данных.

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

Пример: "inline"

dedup_compression_progress

integer

Процент выполнения дедупликации и сжатия.

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

Пример: -1

dedup_compression_status

string

Состояние дедупликации и сжатия.

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

Пример: "ENABLED"

deduplication_compression_mode

string

Режим дедупликации и сжатия.

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

Пример: "compression_deduplication"

emulation_type

string

Тип эмуляции тома.

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

Пример: "3390-V-CVS"

hostgroups

list / elements=dictionary

Список групп хостов, связанных с томом.

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

Пример: []

is_alua

boolean

Указывает, включена ли ALUA.

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

Пример: false

is_command_device

boolean

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

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

is_compression_acceleration_enabled

boolean

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

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

Пример: true

is_data_reduction_share_enabled

boolean

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

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

Пример: true

is_device_group_definition_enabled

boolean

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

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

is_encryption_enabled

boolean

Указывает, включено ли шифрование.

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

Пример: false

is_full_allocation_enabled

boolean

Указывает, включено ли полное выделение.

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

Пример: false

is_relocation_enabled

boolean

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

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

is_security_enabled

boolean

Указывает, включена ли безопасность.

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

is_user_authentication_enabled

boolean

Указывает, включена ли аутентификация пользователей.

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

is_write_protected

boolean

Указывает, включена ли защита от записи.

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

is_write_protected_by_key

boolean

Указывает, включена ли защита от записи с помощью ключа.

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

iscsi_targets

list / elements=dictionary

Список целей iSCSI, связанных с томом.

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

Пример: []

ldev_id

integer

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

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

Пример: 10010

ldev_id_hex

string

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

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

Пример: "00:27:1A"

mp_blade_id

integer

Идентификатор блейда MP.

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

Пример: 3

name

string

Имя тома.

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

Пример: "smrha-258"

num_of_ports

integer

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

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

Пример: 2

nvm_subsystems

list / elements=dictionary

Список подсистем NVMe, связанных с томом.

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

Пример: []

parent_volume_id

integer

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

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

Пример: -1

parent_volume_id_hex

string

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

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

Пример: "-0:00:01"

parity_group_id

string

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

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

Пример: "1-8"

path_count

integer

Количество путей к тому.

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

Пример: 2

pool_id

integer

Идентификатор пула, в котором находится том.

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

Пример: 13

ports

list / elements=dictionary

Список портов, связанных с томом.

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

Пример: [{"host_group_name": "1C-G00", "host_group_number": 156, "lun": 26, "port_id": "CL1-C"}]

host_group_name

string

Имя группы хостов.

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

Пример: "1C-G00"

host_group_number

integer

Номер группы хостов.

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

Пример: 156

lun

integer

Номер логического устройства.

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

Пример: 26

port_id

string

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

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

Пример: "CL1-C"

provision_type

string

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

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

Пример: "CVS"

qos_settings

dictionary

Параметры QoS для тома.

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

resource_group_id

integer

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

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

Пример: 0

snapshots

list / elements=dictionary

Список снимков, связанных с томом.

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

Пример: []

ssid

string

Идентификатор подсистемы для мейнфрейм-томов.

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

Пример: "000C"

status

string

Текущий статус тома.

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

Пример: "NML"

storage_serial_number

string

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

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

Пример: "70033"

tiering_policy

dictionary

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

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

Пример: {}

total_capacity

string

Общая емкость тома.

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

Пример: "54.71GB"

total_capacity_in_mb

float

Общая емкость тома в мегабайтах.

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

Пример: 56023.04

used_capacity

string

Используемая емкость тома.

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

Пример: "0.00B"

used_capacity_in_mb

float

Используемая емкость тома в мегабайтах.

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

Пример: 0.0

virtual_ldev_id

integer

Идентификатор виртуального логического устройства.

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

Пример: -1

virtual_ldev_id_hex

string

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

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

Пример: ""

Авторы

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

Spec-Zone.ru

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