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

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

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

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

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

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
connection_info dictionary / обязательный	Сведения, необходимые для установления соединения с системой хранения.
address string / обязательный	IP-адрес или имя хоста системы хранения.
api_token string	Токен, используемый для работы с заблокированными ресурсами.
connection_type string	Тип соединения с системой хранения. Варианты: `"direct"` ← (по умолчанию)
password string	Пароль для аутентификации. Это обязательное поле.
username string	Имя пользователя для аутентификации. Это обязательное поле.
spec dictionary	Спецификация собираемых фактов о портах хранения.
external_iscsi_ip_address string	IP-адрес цели iSCSI во внешней системе хранения. Обязателен для задач «Получить цель iSCSI порта во внешней системе хранения» и «Получить список LU, определённых для порта iSCSI во внешней системе хранения».
external_iscsi_name string	Имя iSCSI цели во внешней системе хранения. Обязательно для задачи «Получить список LU, определённых для порта iSCSI во внешней системе хранения».
external_tcp_port integer	Номер TCP-порта цели iSCSI во внешней системе хранения. Если этот атрибут не указан, предполагается номер TCP-порта порта локальной системы хранения. Обязателен для задачи «Получить цель iSCSI порта во внешней системе хранения».
external_wwn string	Это поле используется для передачи значения внешнего WWN при работе с внешними системами хранения. Оно применяется для запроса сведений о порте внешней системы хранения. Обязательно для задачи «Получить список LU, определённых для порта Fibre Channel во внешней системе хранения».
port_ids псевдонимы: ports list / elements=string	Идентификаторы конкретных портов, сведения о которых нужно получить. Обязателен для задач «Получить сведения о портах хранения по идентификаторам портов», «Получить цель iSCSI порта во внешней системе хранения», «Получить имя iSCSI внешней системы хранения, зарегистрированной для порта локальной системы хранения», «Получить список портов во внешней системе хранения», «Получить список LU, определённых для порта iSCSI во внешней системе хранения» и «Получить список LU, определённых для порта Fibre Channel во внешней системе хранения».
port_type string	Тип порта во внешней системе хранения. Применяется при получении сведений обо всех портах. Возможные значения: `FIBRE`, `SCSI`, `ISCSI`, `NVME_TCP`, `ENAS`, `ESCON`, `FICON`.
query list / elements=string	Это поле позволяет запрашивать сведения о порте внешней системы хранения. Параметр query принимает одно из значений: `external_iscsi_targets`, `registered_external_iscsi_targets`, `external_storage_ports`, `external_luns`. Обязателен для задач «Получить цель iSCSI порта во внешней системе хранения», «Получить имя iSCSI внешней системы хранения, зарегистрированной для порта локальной системы хранения», «Получить список портов во внешней системе хранения», «Получить список LU, определённых для порта iSCSI во внешней системе хранения» и «Получить список LU, определённых для порта Fibre Channel во внешней системе хранения».
storage_system_info dictionary	Сведения о системе хранения. Это поле является необязательным.
serial string	Серийный номер системы хранения.

Атрибуты

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

Примечания

Примечание

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

Примеры

- name: Get all ports
  hitachivantara.vspone_block.vsp.hv_storage_port_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"

- name: Get information about specific ports
  hitachivantara.vspone_block.vsp.hv_storage_port_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    spec:
      port_ids: ["CLA-1", "CLA-2"]

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

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

Ключ	Описание
port_data list / elements=dictionary	Сведения о порте хранения. Возвращается: success
fabric_mode boolean	Указывает, работает ли порт в режиме fabric. Возвращается: success Пример: `true`
ipv4_address string	IPv4-адрес порта. Возвращается: success Пример: `""`
ipv4_gateway_address string	IPv4-адрес шлюза порта. Возвращается: success Пример: `""`
ipv4_subnetmask string	Маска подсети IPv4 порта. Возвращается: success Пример: `""`
iscsi_window_size string	Размер окна iSCSI порта. Возвращается: success Пример: `""`
keep_alive_timer integer	Значение таймера поддержания активности порта. Возвращается: success Пример: `-1`
loop_id string	Идентификатор цикла порта. Возвращается: success Пример: `"CE"`
lun_security_setting boolean	Указывает, включена ли защита LUN. Возвращается: success Пример: `false`
mac_address string	MAC-адрес порта. Возвращается: success Пример: `""`
port_attributes list / elements=string	Список атрибутов порта. Возвращается: success Пример: `["TAR", "MCU", "RCU", "ELUN"]`
port_connection string	Тип соединения порта. Возвращается: success Пример: `"PtoP"`
port_id string	Идентификатор порта. Возвращается: success Пример: `"CL8-B"`
port_mode string	Режим порта. Возвращается: success Пример: `"FCP-SCSI"`
port_speed string	Скорость порта. Возвращается: success Пример: `"AUT"`
port_type string	Тип порта. Возвращается: success Пример: `"FIBRE"`
storage_serial_number string	Серийный номер системы хранения. Возвращается: success Пример: `"715035"`
tcp_port string	Номер TCP-порта. Возвращается: success Пример: `""`
wwn string	Глобальное имя порта (WWN). Возвращается: success Пример: `"50060e8028274271"`

Авторы

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