Модуль hitachivantara.vspone_block.vsp.hv_hg_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_hg_facts.

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

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

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

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

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
connection_info словарь / обязательный	Информация, необходимая для установления подключения к системе хранения.
address строка / обязательный	IP-адрес или имя хоста системы хранения.
api_token строка	Токен для работы с заблокированными ресурсами.
connection_type строка	Тип подключения к системе хранения. Варианты: `"direct"` ← (по умолчанию)
password строка	Пароль для аутентификации. Это обязательное поле.
username строка	Имя пользователя для аутентификации. Это обязательное поле.
spec словарь	Параметры получения информации о группе хостов.
host_group_number целое число	Фильтрует группы хостов, оставляя только связанные с указанным номером группы хостов. Обязателен для задачи получения сведений о группе хостов по её номеру.
lun целое число	Фильтрует группы хостов, оставляя только связанные с указанным LUN. Обязателен для задачи получения сведений о группе хостов с определённым номером LUN.
name строка	Если указано, фильтрует результаты, оставляя только группы хостов с этим именем. Обязателен для задач получения групп хостов на определённых портах с одинаковым именем группы хостов и получения сведений о группе хостов по её имени.
port_ids псевдонимы: ports список / элементы=строка	Фильтрует группы хостов, оставляя только связанные с указанными портами FC системы хранения. Обязателен для задач получения групп хостов на определённых port_ids, получения групп хостов на определённых port_ids с одинаковым именем группы хостов, получения групп хостов на определённых port_ids, включая WWN и LDEV, а также получения сведений о группе хостов по её номеру, имени или по определённому номеру LUN.
query список / элементы=строка	Определяет, какую информацию возвращать о группах хостов. Можно указать «wwns» для WWN HBA, «ldevs» для сопоставленных LDEV или оба значения. Обязателен для задачи получения групп хостов на определённых port_ids, включая WWN и LDEV. Варианты: `"wwns"` `"ldevs"` По умолчанию: `[]`
storage_system_info словарь	Информация о системе хранения. Это необязательное поле.
serial строка	Серийный номер системы хранения.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Определяет, должен ли модуль запускаться в режиме проверки.

Примечания

Примечание

Выходные параметры entitlement_status, subscriber_id и partner_id удалены в версии 3.4.0. Они также признаны устаревшими из-за упрощения внутреннего API и больше не поддерживаются.
Тип подключения gateway удалён начиная с версии 3.4.0. Если вам нужен этот тип подключения, используйте более раннюю версию.

Примеры

- name: Get all host groups
  hitachivantara.vspone_block.vsp.hv_hg_facts:
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"

- name: Get Host Groups of specific ports
  hitachivantara.vspone_block.vsp.hv_hg_facts:
    connection_info:
      address: storage1.company.com
      username: "dummy_user"
      password: "dummy_password"
    spec:
      port_ids: ['CL1-A', 'CL2-B']

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

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

Ключ	Описание
hostGroups list / elements=dictionary	Список групп хостов, полученных из системы хранения данных. Возвращается: всегда
host_group_id integer	Идентификатор группы хостов. Возвращается: при успехе Пример: `33`
host_group_name string	Имя группы хостов. Возвращается: при успехе Пример: `"AutoAnsibleHurPri01"`
host_mode string	Режим хоста для группы хостов. Возвращается: при успехе Пример: `"LINUX"`
host_mode_options list / elements=dictionary	Список параметров режима хоста. Возвращается: при успехе
host_mode_option string	Параметр режима хоста. Возвращается: при успехе Пример: `"EXTENDED_COPY"`
host_mode_option_number integer	Номер параметра режима хоста. Возвращается: при успехе Пример: `54`
lun_paths list / elements=dictionary	Список путей LUN. Возвращается: при успехе
asymmetric_access_state string	Состояние асимметричного доступа. Возвращается: при успехе Пример: `"Active/Optimized"`
host_group_number integer	Номер группы хостов. Возвращается: при успехе Пример: `33`
host_mode string	Режим хоста для пути LUN. Возвращается: при успехе Пример: `"LINUX/IRIX"`
host_mode_options list / elements=dictionary	Список параметров режима хоста для пути LUN. Возвращается: при успехе
is_alua_enabled boolean	Указывает, включена ли ALUA. Возвращается: при успехе Пример: `false`
is_command_device boolean	Указывает, является ли это командным устройством. Возвращается: при успехе Пример: `false`
ldev_id integer	Идентификатор LDEV. Возвращается: при успехе Пример: `3694`
ldev_id_hex string	Идентификатор LDEV в шестнадцатеричном формате. Возвращается: при успехе Пример: `"00:0E:6E"`
lu_host_reserve dictionary	Информация о резервировании LU для хоста. Возвращается: при успехе
aca_reserve boolean	Состояние резервирования ACA. Возвращается: при успехе Пример: `false`
mainframe boolean	Состояние резервирования мейнфрейма. Возвращается: при успехе Пример: `false`
open_system boolean	Состояние резервирования открытой системы. Возвращается: при успехе Пример: `false`
persistent boolean	Состояние постоянного резервирования. Возвращается: при успехе Пример: `false`
pgr_key boolean	Состояние ключа PGR. Возвращается: при успехе Пример: `false`
lun integer	Номер LUN. Возвращается: при успехе Пример: `17`
lun_id string	Идентификатор LUN. Возвращается: при успехе Пример: `"CL4-B,33,17"`
port_id string	Идентификатор порта для пути LUN. Возвращается: при успехе Пример: `"CL4-B"`
port_id string	Порт, связанный с группой хостов. Возвращается: при успехе Пример: `"CL4-B"`
resource_group_id integer	Идентификатор группы ресурсов. Возвращается: при успехе Пример: `0`
wwns list / elements=dictionary	Список WWN. Возвращается: при успехе
id string	Идентификатор WWN. Возвращается: при успехе Пример: `"1212121212121212"`
name string	Имя, связанное с WWN. Возвращается: при успехе Пример: `""`

Авторы

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_hg_facts_module.html