Spec-Zone.ru › Ansible

Модуль hitachivantara.vspone_block.vsp.hv_vsp_one_port — управление портами систем хранения данных VSP E series, VSP One Block 20 series и VSP One Block 80 series.

Примечание

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

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

  • Обзор
  • Требования
  • Параметры
  • Атрибуты
  • Примеры
  • Возвращаемые значения

Обзор

  • Этот модуль управляет конфигурацией портов систем хранения данных VSP E series, VSP One Block 20 series и VSP One Block 80 series.
  • Для управления портами моделей VSP One B20 series, VSP One B80 series и VSP E series используется Hitachi Virtual Storage Platform One Simple API.
  • Примеры использования см. по адресу https://github.com/hitachi-vantara/vspone-block-ansible/blob/main/playbooks/vsp_direct/vsp_one_port.yml

Требования

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

  • python >= 3.9

Параметры

Параметр

Комментарии

connection_info

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

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

address

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

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

api_token

string

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

password

string

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

username

string

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

spec

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

Параметры конфигурации для управления настройками портов.

enable_port_security

boolean

Включать ли защиту порта. Требуется для задач «Настройка основных параметров порта (защита и скорость порта)» / «Настройка порта FC со всеми параметрами» / «Настройка порта iSCSI с полным набором параметров».

Допустимые значения:

  • false
  • true

fc_settings

dictionary

Параметры Fibre Channel. Требуется для задачи «Настройка порта FC со всеми параметрами».

al_pa

string

Физический адрес арбитрируемого контура. Требуется для задачи «Настройка порта FC со всеми параметрами».

connection_type

string

Варианты типа подключения FC: Point_To_Point и FC_AL; регистр не учитывается. Требуется для задачи «Настройка порта FC со всеми параметрами».

should_enable_fabric_switch_setting

boolean

Включать ли настройку коммутатора фабрики. Требуется для задачи «Настройка порта FC со всеми параметрами».

Допустимые значения:

  • false
  • true

iscsi_settings

dictionary

Параметры iSCSI. Требуется для задач «Настройка порта iSCSI с полным набором параметров» / «Удаление VLAN с порта iSCSI».

add_vlan_id

integer

ID VLAN для добавления. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

delete_vlan_id

integer

ID VLAN для удаления. Требуется для задачи «Удаление VLAN с порта iSCSI».

enable_delayed_ack

boolean

Включать ли отложенное подтверждение (ACK). Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

Допустимые значения:

  • false
  • true

enable_isns_server_mode

boolean

Включать ли режим сервера iSNS. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

Допустимые значения:

  • false
  • true

enable_selective_ack

boolean

Включать ли выборочное подтверждение (ACK). Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

Допустимые значения:

  • false
  • true

enable_virtual_port

boolean

Включать ли виртуальный порт.

Допустимые значения:

  • false
  • true

enable_vlan_use

boolean

Включать ли использование VLAN. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

Допустимые значения:

  • false
  • true

ip_mode

string

Настройка режима IP. Варианты: ipv4 и ipv4v6; регистр не учитывается. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

ipv4_configuration

dictionary

Параметры конфигурации IPv4. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

address

string

Адрес IPv4. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

default_gateway

string

Шлюз IPv4 по умолчанию. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

subnet_mask

string

Маска подсети IPv4. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

ipv6_configuration

dictionary

Параметры конфигурации IPv6. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

default_gateway

string

Шлюз IPv6 по умолчанию. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

global

string

Глобальный адрес IPv6. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

linklocal

string

Локальный для канала адрес IPv6. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

isns_server_ip_address

string

IP-адрес сервера iSNS. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

isns_server_port

integer

Порт сервера iSNS. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

keep_alive_timer

integer

Значение таймера поддержания активности. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

mtu_size

string

Размер MTU. Варианты: NUMBER_1500, NUMBER_4500, NUMBER_9000; регистр не учитывается. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

tcp_port

integer

Номер порта TCP. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

window_size

string

Размер окна TCP. Варианты: NUMBER_16K, NUMBER_32K, NUMBER_64K, NUMBER_128K, NUMBER_256K, NUMBER_512K, NUMBER_1024K; регистр не учитывается. Требуется для задачи «Настройка порта iSCSI с полным набором параметров».

nvme_tcp_settings

dictionary

Параметры NVMe over TCP. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

add_vlan_id

integer

ID VLAN для добавления. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

delete_vlan_id

integer

ID VLAN для удаления.

discovery_tcp_port

integer

Номер порта TCP для обнаружения. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

enable_delayed_ack

boolean

Включать ли отложенное подтверждение (ACK). Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

Допустимые значения:

  • false
  • true

enable_selective_ack

boolean

Включать ли выборочное подтверждение (ACK). Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

Допустимые значения:

  • false
  • true

enable_vlan_use

boolean

Включать ли использование VLAN. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

Допустимые значения:

  • false
  • true

ip_mode

string

Настройка режима IP. Варианты: ipv4 и ipv4v6; регистр не учитывается. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

ipv4_configuration

dictionary

Параметры IPv4. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

address

string

Адрес IPv4. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

default_gateway

string

Шлюз IPv4 по умолчанию. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

subnet_mask

string

Маска подсети IPv4. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

ipv6_configuration

dictionary

Параметры IPv6. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

default_gateway

string

Шлюз IPv6 по умолчанию. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

global_

string

Глобальный адрес IPv6. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

linklocal

string

Локальный для канала адрес IPv6. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

mtu_size

string

Размер MTU. Варианты: NUMBER_1500, NUMBER_4500, NUMBER_9000; регистр не учитывается. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

tcp_port

integer

Номер порта TCP. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

window_size

string

Размер окна TCP. Варианты: NUMBER_64K, NUMBER_128K, NUMBER_256K, NUMBER_512K, NUMBER_1024K; регистр не учитывается. Требуется для задачи «Настройка порта NVMe over TCP со всеми параметрами».

port_id

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

Идентификатор настраиваемого порта. Требуется для задач «Настройка основных параметров порта (защита и скорость порта)» / «Настройка порта FC со всеми параметрами» / «Настройка порта iSCSI с полным набором параметров» / «Настройка порта NVMe over TCP со всеми параметрами» / «Удаление VLAN с порта iSCSI» / «Настройка порта с минимальным набором параметров».

port_speed_in_gbps

integer

Скорость порта в Гбит/с. Требуется для задач «Настройка основных параметров порта (защита и скорость порта)» / «Настройка порта FC со всеми параметрами» / «Настройка порта iSCSI с полным набором параметров» / «Настройка порта NVMe over TCP со всеми параметрами» / «Настройка порта с минимальным набором параметров».

Допустимые значения:

  • 0
  • 1
  • 4
  • 8
  • 10
  • 16
  • 25
  • 32
  • 64
  • 100

Атрибуты

Атрибут

Поддержка

Описание

check_mode

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

Указывает, работает ли модуль в режиме проверки.

Примеры

- name: Configure basic port settings (port security and speed)
  hitachivantara.vspone_block.vsp.hv_vsp_one_port:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      port_id: "CL1-C"
      port_speed_in_gbps: 32
      enable_port_security: true

- name: Configure FC port with all settings
  hitachivantara.vspone_block.vsp.hv_vsp_one_port:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      port_id: "CL2-A"
      port_speed_in_gbps: 16
      enable_port_security: false
      fc_settings:
        al_pa: "0x01"
        should_enable_fabric_switch_setting: true
        connection_type: "Point_To_Point"

- name: Configure iSCSI port with comprehensive settings
  hitachivantara.vspone_block.vsp.hv_vsp_one_port:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      port_id: "CL3-B"
      port_speed_in_gbps: 25
      enable_port_security: true
      iscsi_settings:
        enable_vlan_use: true
        add_vlan_id: 100
        ip_mode: "ipv4v6"
        ipv4_configuration:
          address: "192.168.1.100"
          subnet_mask: "255.255.255.0"
          default_gateway: "192.168.1.1"
        ipv6_configuration:
          linklocal: "fe80::1"
          global: "2001:db8::100"
          default_gateway: "2001:db8::1"
        tcp_port: 3260
        enable_selective_ack: true
        enable_delayed_ack: false
        window_size: "NUMBER_256K"
        mtu_size: "NUMBER_9000"
        keep_alive_timer: 300
        enable_isns_server_mode: true
        isns_server_ip_address: "192.168.1.200"
        isns_server_port: 3205
        enable_virtual_port: false

- name: Configure NVMe over TCP port with all parameters
  hitachivantara.vspone_block.vsp.hv_vsp_one_port:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      port_id: "CL4-D"
      port_speed_in_gbps: 100
      enable_port_security: false
      nvme_tcp_settings:
        enable_vlan_use: true
        add_vlan_id: 200
        ip_mode: "ipv4"
        ipv4_settings:
          address: "10.0.1.50"
          subnet_mask: "255.255.255.0"
          default_gateway: "10.0.1.1"
        ipv6_settings:
          linklocal: "fe80::2"
          global_: "2001:db8:1::50"
          default_gateway: "2001:db8:1::1"
        tcp_port: 4420
        discovery_tcp_port: 8009
        enable_selective_ack: false
        enable_delayed_ack: true
        window_size: "NUMBER_512K"
        mtu_size: "NUMBER_4500"

- name: Remove VLAN from iSCSI port
  hitachivantara.vspone_block.vsp.hv_vsp_one_port:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      port_id: "CL3-B"
      iscsi_settings:
        delete_vlan_id: 100

- name: Configure port with minimal settings
  hitachivantara.vspone_block.vsp.hv_vsp_one_port:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      port_id: "CL1-A"
      port_speed_in_gbps: 0  # Auto speed

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

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

Ключ

Описание

port

dictionary

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

Возвращается: всегда

actual_port_speed

string

Текущая фактическая скорость порта.

Возвращается: при успехе

Пример: "LINK_DOWN"

fc_information

dictionary

Сведения Fibre Channel для порта.

Возвращается: при успехе

al_pa

string

Физический адрес арбитражного кольца.

Возвращается: при успехе

Пример: "EF"

connection_type

string

Тип подключения Fibre Channel.

Возвращается: при успехе

Пример: "FC_AL"

fabric_switch_setting

boolean

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

Возвращается: при успехе

Пример: false

port_mode

string

Настройка режима порта.

Возвращается: при успехе

Пример: "SCSI"

sfp_data_transfer_rate

string

Скорость передачи данных SFP.

Возвращается: при успехе

Пример: "NUMBER_16"

id

string

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

Возвращается: при успехе

Пример: "CL4-D"

iscsi_information

dictionary

Сведения iSCSI для порта.

Возвращается: при успехе

delayed_ack

boolean

Настройка отложенного подтверждения ACK.

Возвращается: при успехе

Пример: true

ip_mode

string

Режим IP (ipv4 или ipv6).

Возвращается: при успехе

Пример: "ipv4"

ipv4_information

dictionary

Сведения о конфигурации IPv4.

Возвращается: при успехе

address

string

Адрес IPv4.

Возвращается: при успехе

Пример: "192.168.0.74"

default_gateway

string

Адрес шлюза по умолчанию.

Возвращается: при успехе

Пример: "0.0.0.0"

subnet_mask

string

Маска подсети.

Возвращается: при успехе

Пример: "255.255.255.0"

ipv6_information

dictionary

Сведения о конфигурации IPv6.

Возвращается: при успехе

default_gateway

string

Шлюз IPv6 по умолчанию.

Возвращается: при успехе

Пример: "::"

global

string

Режим глобальной конфигурации IPv6.

Возвращается: при успехе

Пример: "Auto"

global_address

string

Глобальный адрес IPv6.

Возвращается: при успехе

Пример: "::"

global_address_status

string

Состояние глобального адреса IPv6.

Возвращается: при успехе

Пример: "INVALID"

linklocal

string

Режим локальной конфигурации IPv6 для канала связи.

Возвращается: при успехе

Пример: "Auto"

linklocal_address

string

Локальный адрес IPv6 для канала связи.

Возвращается: при успехе

Пример: "fe80::"

linklocal_address_status

string

Состояние локального адреса IPv6 для канала связи.

Возвращается: при успехе

Пример: "INVALID"

is_ipv6_updating

boolean

Указывает, выполняется ли в данный момент обновление IPv6.

Возвращается: при успехе

Пример: false

isns_server_ip_address

string

IP-адрес сервера iSNS.

Возвращается: при успехе

Пример: "0.0.0.0"

isns_server_mode

boolean

Указывает, включен ли режим сервера iSNS.

Возвращается: при успехе

Пример: false

isns_server_port

integer

Номер порта сервера iSNS.

Возвращается: при успехе

Пример: 3205

keep_alive_timer

integer

Значение таймера поддержания активности в секундах.

Возвращается: при успехе

Пример: 60

link_mtu_size

string

Размер MTU канала связи.

Возвращается: при успехе

Пример: "NUMBER_1500"

mtu_size

string

Размер MTU.

Возвращается: при успехе

Пример: "NUMBER_1500"

selective_ack

boolean

Настройка выборочного подтверждения ACK.

Возвращается: при успехе

Пример: true

tcp_port

integer

Номер порта TCP.

Возвращается: при успехе

Пример: 3260

virtual_port_enabled

boolean

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

Возвращается: при успехе

Пример: false

vlan_use

boolean

Указывает, используется ли VLAN.

Возвращается: при успехе

Пример: false

window_size

string

Размер окна TCP.

Возвращается: при успехе

Пример: "NUMBER_64K"

nvme_tcp_information

dictionary

Сведения о NVMe over TCP для порта.

Возвращается: при успехе

delayed_ack

boolean

Настройка отложенного подтверждения ACK.

Возвращается: при успехе

Пример: true

ip_mode

string

Режим IP (ipv4 или ipv6).

Возвращается: при успехе

Пример: "ipv4"

ipv4_information

dictionary

Сведения о конфигурации IPv4.

Возвращается: при успехе

address

string

Адрес IPv4.

Возвращается: при успехе

Пример: "192.168.0.78"

default_gateway

string

Адрес шлюза по умолчанию.

Возвращается: при успехе

Пример: "0.0.0.0"

subnet_mask

string

Маска подсети.

Возвращается: при успехе

Пример: "255.255.255.0"

ipv6_information

dictionary

Сведения о конфигурации IPv6.

Возвращается: при успехе

is_ipv6_updating

boolean

Указывает, выполняется ли в данный момент обновление IPv6.

Возвращается: при успехе

Пример: false

link_mtu_size

string

Размер MTU канала связи.

Возвращается: при успехе

Пример: "NUMBER_1500"

mtu_size

string

Размер MTU.

Возвращается: при успехе

Пример: "NUMBER_1500"

tcp_port

integer

Номер порта TCP.

Возвращается: при успехе

Пример: 4420

virtual_port_enabled

boolean

Включён ли виртуальный порт.

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

Пример: false

port_iscsi_name

string

Имя iSCSI для порта.

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

Пример: ""

port_security

boolean

Включена ли защита порта.

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

Пример: false

port_speed

string

Настроенная скорость порта.

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

Пример: "NUMBER_100"

port_wwn

string

Адрес WWN порта.

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

Пример: ""

protocol

string

Протокол, используемый портом.

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

Пример: "NVME_TCP"

Авторы

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

Spec-Zone.ru

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