Модуль hitachivantara.vspone_block.vsp.hv_storage_port — изменение настроек портов хранения в блочных системах хранения 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.

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

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

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

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

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
connection_info dictionary / обязательный	Сведения, необходимые для подключения к системе хранения.
address string / обязательный	IP-адрес или имя хоста системы хранения.
api_token string	Токен для работы с заблокированными ресурсами.
connection_type string	Тип подключения к системе хранения. Варианты: `"direct"` ← (по умолчанию)
password string	Пароль для аутентификации. Это обязательное поле.
username string	Имя пользователя для аутентификации. Это обязательное поле.
spec dictionary	Спецификация задач для портов хранения.
enable_port_security boolean	Укажите, следует ли включить настройку безопасности LUN для порта. Обязательный параметр для задачи «Изменение настройки безопасности порта хранения по идентификатору порта». Варианты: `false` `true`
external_iscsi_targets list / elements=dictionary	Сведения о целевом объекте iSCSI внешней системы хранения. Обязательный параметр для задач «Выполнение теста входа в систему на целевых объектах iSCSI внешней системы хранения, зарегистрированной на порту локальной системы хранения», «Регистрация имён iSCSI внешней системы хранения на порту локальной системы хранения» и «Отмена регистрации имён iSCSI внешней системы хранения на порту локальной системы хранения».
ip_address string / обязательный	IP-адрес целевого объекта iSCSI внешней системы хранения. Обязательный параметр для задач «Выполнение теста входа в систему на целевых объектах iSCSI внешней системы хранения, зарегистрированной на порту локальной системы хранения», «Регистрация имён iSCSI внешней системы хранения на порту локальной системы хранения» и «Отмена регистрации имён iSCSI внешней системы хранения на порту локальной системы хранения».
name string / обязательный	Имя iSCSI целевого объекта iSCSI внешней системы хранения. Обязательный параметр для задач «Выполнение теста входа в систему на целевых объектах iSCSI внешней системы хранения, зарегистрированной на порту локальной системы хранения», «Регистрация имён iSCSI внешней системы хранения на порту локальной системы хранения» и «Отмена регистрации имён iSCSI внешней системы хранения на порту локальной системы хранения».
tcp_port integer	Номер TCP-порта целевого объекта iSCSI внешней системы хранения.
fabric_mode boolean	Режим fabric порта. Если значение равно true, режим включён. Если значение равно false, режим не включён. При указании этого атрибута обязательно укажите также атрибут port_connection. Обязательный параметр для задачи «Изменение режима fabric и настроек подключения порта хранения по идентификатору порта». Варианты: `false` `true`
host_ip_address string	Отправка команды ping с указанного порта iSCSI или NVMe/TCP системы хранения на хост. Если указано это значение, будут возвращены результаты ping, а остальные параметры будут проигнорированы. Обязательный параметр для задачи «Отправка команды ping указанному хосту».
port_attribute string	Укажите атрибут порта. Допустимые значения: ‘TAR’ или ‘ALL’. Используйте ‘TAR’ для порта Fibre Target и ‘ALL’ для двунаправленного порта. Этот атрибут нельзя указывать одновременно с любым другим атрибутом. Обязательный параметр для задачи «Изменение атрибута порта хранения по идентификатору порта».
port_connection string	Настройка топологии порта. Допустимые значения: ‘FCAL’, ‘P2P’ или ‘PtoP’. При указании этого атрибута обязательно укажите также атрибут fabric_mode. Обязательный параметр для задачи «Изменение режима fabric и настроек подключения порта хранения по идентификатору порта».
port_id псевдонимы: port string / обязательный	Идентификатор порта, для которого требуется получить сведения. Обязательный параметр для задач «Изменение настройки безопасности порта хранения по идентификатору порта», «Изменение режима порта хранения по идентификатору порта», «Изменение атрибута порта хранения по идентификатору порта», «Изменение режима fabric и настроек подключения порта хранения по идентификатору порта», «Выполнение теста входа в систему на целевых объектах iSCSI внешней системы хранения, зарегистрированной на порту локальной системы хранения», «Регистрация имён iSCSI внешней системы хранения на порту локальной системы хранения», «Отмена регистрации имён iSCSI внешней системы хранения на порту локальной системы хранения» и «Отправка команды ping указанному хосту».
port_mode string	Укажите режим работы порта. Допустимые значения: ‘FC-NVMe’ или ‘FCP-SCSI’. Для VSP One B85 нельзя указывать для режима порта значение ‘FC-NVMe’. Этот атрибут нельзя указывать одновременно с любым другим атрибутом. Обязательный параметр для задачи «Изменение режима порта хранения по идентификатору порта».
port_speed string	Укажите скорость передачи данных порта. Допустимые значения: ‘AUT’ или ‘nG’, где n — число, а G можно опустить.
state string	Уровень выполнения задач для порта. Допустимые значения: `present`, `login_test`, `register_external_iscsi_target`, `unregister_external_iscsi_target`. Варианты: `"present"` ← (по умолчанию) `"login_test"` `"register_external_iscsi_target"` `"unregister_external_iscsi_target"`
storage_system_info dictionary	Сведения о системе хранения. Это необязательное поле.
serial string	Серийный номер системы хранения.

Атрибуты

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

Примечания

Примечание

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

Примеры

- name: Change attribute setting of the storage port by port id
  hitachivantara.vspone_block.vsp.hv_storage_port:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    spec:
      port_id: "CL8-B"
      port_attribute: "TAR"  # Options: "TAR", "ALL"

- name: Change port mode setting of the storage port by port id
  hitachivantara.vspone_block.vsp.hv_storage_port:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    spec:
      port_id: "CL8-B"
      port_mode: "FC-NVMe"  # Options: "FC-NVMe", "FCP-SCSI"

- name: Change port security setting of the storage port by port id
  hitachivantara.vspone_block.vsp.hv_storage_port:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    spec:
      port_id: "CL1-A"
      enable_port_security: true

- name: Perform a login test
  hitachivantara.vspone_block.vsp.hv_storage_port:
    connection_info: "{{ connection_info }}"
    state: "login_test"
    spec:
      port_id: "CL1-C"
      external_iscsi_target:
        ip_address: "172.25.59.213"
        name: "iqn.1994-04.jp.co.hitachi:rsd.has.t.10045.1c019"

- name: Sending the ping command to a specified host
  hitachivantara.vspone_block.vsp.hv_storage_port:
    connection_info: "{{ connection_info }}"
    state: "login_test"
    spec:
      port: "CL1-C"
      host_ip_address: "172.25.59.213"

Возвращаемые значения

Общие возвращаемые значения описаны здесь, ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
port_info dictionary	Информация о порте хранилища. Возвращается: всегда
fabric_mode boolean	Указывает, находится ли порт в режиме fabric. Возвращается: при успешном выполнении Пример: `true`
ipv4_address string	IPv4-адрес порта. Возвращается: при успешном выполнении Пример: `""`
ipv4_gateway_address string	IPv4-адрес шлюза порта. Возвращается: при успешном выполнении Пример: `""`
ipv4_subnetmask string	Маска подсети IPv4 порта. Возвращается: при успешном выполнении Пример: `""`
iscsi_window_size string	Размер окна iSCSI. Возвращается: при успешном выполнении Пример: `""`
keep_alive_timer integer	Значение таймера поддержания активности. Возвращается: при успешном выполнении Пример: `-1`
logins list / elements=dictionary	Список WWN для входа и псевдонимов. Возвращается: при успешном выполнении
loginWwn string	WWN для входа. Возвращается: при успешном выполнении Пример: `"50060e80212b1841"`
wwnNickName string	Псевдоним WWN. Возвращается: при успешном выполнении Пример: `"-"`
loop_id string	Идентификатор цикла порта. Возвращается: при успешном выполнении Пример: `"D4"`
mac_address string	MAC-адрес порта. Возвращается: при успешном выполнении Пример: `""`
port_attributes list / elements=string	Список атрибутов порта. Возвращается: при успешном выполнении Пример: `["TAR", "MCU", "RCU", "ELUN"]`
port_connection string	Тип подключения порта. Возвращается: при успешном выполнении Пример: `"PtoP"`
port_id string	Идентификатор порта. Возвращается: при успешном выполнении Пример: `"CL8-A"`
port_mode string	Режим работы порта. Возвращается: при успешном выполнении Пример: `"FCP-SCSI"`
port_security_setting boolean	Указывает, включена ли настройка безопасности порта. Возвращается: при успешном выполнении Пример: `true`
port_speed string	Скорость порта. Возвращается: при успешном выполнении Пример: `"16G"`
port_type string	Тип порта. Возвращается: при успешном выполнении Пример: `"FIBRE"`
tcp_mtu string	Значение MTU TCP. Возвращается: при успешном выполнении Пример: `""`
tcp_port string	Номер порта TCP. Возвращается: при успешном выполнении Пример: `""`
wwn string	Имя World Wide Name порта. Возвращается: при успешном выполнении Пример: `"50060e8028274270"`

Авторы

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