cisco.intersight.intersight_port_policy module – Управление политиками портов Cisco Intersight

api_key_id

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

Идентификатор открытого ключа API, связанного с закрытым ключом.

Если значение не задано, используется значение переменной среды INTERSIGHT_API_KEY_ID.

api_private_key

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

Имя файла (абсолютный путь) или строка с данными закрытого ключа в формате PEM для аутентификации в API Intersight.

Если используется строка, для ее шифрования следует использовать Ansible Vault.

Например: ansible-vault encrypt_string --vault-id tme@/Users/dsoper/Documents/vault_password_file ‘-----BEGIN EC PRIVATE KEY-----

<your private key data>

-----END EC PRIVATE KEY-----’

Если значение не задано, используется значение переменной среды INTERSIGHT_API_PRIVATE_KEY.

api_uri

string

URI для доступа к API Intersight.

Если значение не задано, используется значение переменной среды INTERSIGHT_API_URI.

По умолчанию: "https://intersight.com/api/v1"

appliance_port_channels

list / elements=dictionary

Список конфигураций каналов портов устройства.

Каналы портов для подключения непосредственно присоединенных устройств хранения данных.

admin_speed

string

Административная скорость канала портов.

Варианты:

• "Auto" ← (по умолчанию)
• "1Gbps"
• "10Gbps"
• "25Gbps"
• "40Gbps"
• "100Gbps"

eth_network_control_policy_name

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

Имя политики управления сетью Ethernet (обязательно).

Связь с политикой управления сетью Fabric.

eth_network_group_policy_name

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

Имя политики группы сети Ethernet (обязательно).

Связь с политикой группы сети Fabric.

fec

string

Режим коррекции ошибок Forward Error Correction (FEC).

Варианты:

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

link_aggregation_policy_name

string

Имя связываемой политики агрегации каналов.

Связь с политикой агрегации каналов.

mode

string

Режим порта для канала портов устройства.

Варианты:

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

pc_id

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

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

Допустимый диапазон: 1–256.

ports

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

Список портов Ethernet, включаемых в канал портов.

port_id

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

Идентификатор порта, включаемого в канал портов.

Это может быть обычный порт (например, 36) или агрегированный порт (например, ‘49/2’).

Для агрегированных портов используется синтаксис портов с разбиением: ‘49/2’ означает подпорт 2 порта 49.

priority

string

Приоритет QoS для канала портов устройства.

Варианты:

• "Best Effort" ← (по умолчанию)
• "FC"
• "Platinum"
• "Gold"
• "Silver"
• "Bronze"

state

string

Создать/обновить или удалить канал портов.

Варианты:

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

user_label

string

Задаваемая пользователем метка канала портов.

Метка пользователя должна содержать от 0 до 128 буквенно-цифровых символов.

appliance_ports

list / elements=dictionary

Список конфигураций портов устройства.

Порты устройства используются для подключения непосредственно присоединенных устройств хранения данных.

admin_speed

string

Административная скорость порта.

Скорость 1Gbps разрешена только для портов 45–48.

Скорости 40Gbps и 100Gbps разрешены только для портов 49–54.

Варианты:

• "Auto" ← (по умолчанию)
• "1Gbps"
• "10Gbps"
• "25Gbps"
• "40Gbps"
• "100Gbps"

eth_network_control_policy_name

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

Имя политики управления сетью Ethernet (обязательно).

Связь с политикой управления сетью Fabric.

eth_network_group_policy_name

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

Имя политики группы сети Ethernet (обязательно).

Связь с политикой группы сети Fabric.

fec

string

Режим коррекции ошибок Forward Error Correction (FEC).

Варианты:

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

mode

string

Режим порта для порта устройства.

Варианты:

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

port_id

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

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

Это может быть обычный порт (например, 13) или агрегированный порт (например, ‘49/1’).

priority

string

Приоритет QoS для порта устройства.

Варианты:

• "Best Effort" ← (по умолчанию)
• "FC"
• "Platinum"
• "Gold"
• "Silver"
• "Bronze"

state

string

Создать/обновить или удалить порт устройства.

Варианты:

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

user_label

string

Задаваемая пользователем метка порта.

Метка пользователя должна содержать от 0 до 128 буквенно-цифровых символов.

breakout_ports

list / elements=dictionary

Список конфигураций портов с разбиением.

Разбиение портов позволяет разделить высокоскоростной порт на несколько портов с меньшей скоростью.

Поддержка разбиения зависит от модели устройства (см. документацию по device_model).

UCS-FI-6664 не поддерживает разбиение портов.

custom_mode

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

Режим разбиения портов.

Режимы разбиения Ethernet (BreakoutEthernet10G, BreakoutEthernet25G) поддерживаются всеми моделями с поддержкой разбиения.

Режимы разбиения FC (BreakoutFibreChannel8G, BreakoutFibreChannel16G, BreakoutFibreChannel32G) поддерживаются только на UCS-FI-6536 и UCSX-S9108-100G.

Варианты:

• "BreakoutEthernet10G"
• "BreakoutEthernet25G"
• "BreakoutFibreChannel8G"
• "BreakoutFibreChannel16G"
• "BreakoutFibreChannel32G"

port_id

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

Идентификатор порта, настраиваемого для разбиения.

Этот порт будет разделен на несколько подпортов (например, ‘49/1’, ‘49/2’, ‘49/3’, ‘49/4’).

Порт должен входить в поддерживаемый устройством диапазон портов с разбиением.

UCS-FI-6454: порты 49–54 (только разбиение Ethernet)

UCS-FI-64108: порты 97–108 (только разбиение Ethernet)

UCS-FI-6536: порты 1–32 (только разбиение Ethernet), порты 33–36 (только разбиение FC)

UCSX-S9108-100G: порты 1–2 (только разбиение FC), порты 3–6 (разбиение Ethernet)

UCS-FI-6536: порты 1–36 (включая порты FC)

UCSX-S9108-100G: порты 1–8

state

string

Создать/обновить или удалить конфигурацию разбиения порта.

Варианты:

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

description

псевдонимы: descr

string

Описание политики портов, заданное пользователем.

Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или подчеркивание (_).

device_model

string

Модель устройства, для которой предназначена политика портов.

Для разных моделей поддерживаются разные конфигурации и возможности портов.

Обязательно, когда state=present.

UCS-FI-6454: 54 порта (1–54), порты FC 1–16, порты с разбиением 49–54

UCS-FI-64108: 108 портов (1–108), порты FC 1–16, порты с разбиением 97–108, скорость 1Gbps только на портах 89–96, скорость 40/100Gbps только на портах 97–108

UCS-FI-6536: 36 портов (1–36), FC поддерживается только через разбиение портов 33–36, все порты поддерживают разбиение, скорость 1Gbps только на портах 9–10

UCS-FI-6664: 64 порта (1–64), порты FC 25–40, разбиение не поддерживается, скорость 40/100Gbps только на портах 1–24 и 41–64

UCSX-S9108-100G: 8 портов (1–8), FC поддерживается только через разбиение портов 1–2, скорость 1Gbps только на портах 7–8

Варианты:

• "UCS-FI-6454"
• "UCS-FI-64108"
• "UCS-FI-6536"
• "UCS-FI-6664"
• "UCSX-S9108-100G"

ethernet_uplink_port_channels

list / elements=dictionary

Список конфигураций каналов портов восходящего подключения Ethernet.

Каналы портов объединяют несколько портов Ethernet в одно логическое соединение.

admin_speed

string

Административная скорость канала портов.

Варианты:

• "Auto" ← (по умолчанию)
• "1Gbps"
• "10Gbps"
• "25Gbps"
• "40Gbps"
• "100Gbps"

eth_network_group_policy_names

list / elements=string

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

Политика группы сети Ethernet задает набор VLAN, разрешенных на порту восходящего подключения.

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

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

Обратите внимание: VLAN-1 по умолчанию разрешается автоматически и может быть указан как собственный VLAN.

fec

string

Режим коррекции ошибок Forward Error Correction (FEC).

Варианты:

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

flow_control_policy_name

string

Имя связываемой политики управления потоком.

link_aggregation_policy_name

string

Имя связываемой политики агрегации каналов.

link_control_policy_name

string

Имя связываемой политики управления каналом.

pc_id

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

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

Допустимый диапазон: 1–256.

ports

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

Список портов Ethernet, включаемых в канал портов.

port_id

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

Идентификатор порта, включаемого в канал портов.

Это может быть обычный порт (например, 36) или агрегированный порт (например, ‘49/2’).

Для агрегированных портов используется синтаксис портов с разбиением: ‘49/2’ означает подпорт 2 порта 49.

state

string

Создать/обновить или удалить канал портов.

Варианты:

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

user_label

string

Задаваемая пользователем метка канала портов.

Метка пользователя должна содержать от 0 до 128 буквенно-цифровых символов.

ethernet_uplink_ports

list / elements=dictionary

Список конфигураций портов восходящего подключения Ethernet.

Порты восходящего подключения Ethernet соединяются с вышестоящими сетевыми коммутаторами.

admin_speed

string

Административная скорость порта.

В зависимости от номера порта действуют ограничения скорости.

Варианты:

• "Auto" ← (по умолчанию)
• "1Gbps"
• "10Gbps"
• "25Gbps"
• "40Gbps"
• "100Gbps"

eth_network_group_policy_name

list / elements=string

Список имен политик групп Ethernet-сетей.

Политика группы Ethernet-сетей определяет набор VLAN, разрешенных на восходящем порту.

Указанный набор VLAN должен быть либо идентичным наборам, указанным на других восходящих интерфейсах, либо не пересекаться с ними.

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

Обратите внимание: VLAN-1 по умолчанию разрешен автоматически и может быть указан как исходный VLAN.

fec

string

Режим коррекции ошибок при передаче (FEC).

Варианты:

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

flow_control_policy_name

string

Имя политики управления потоком.

link_control_policy_name

string

Имя политики управления каналом.

mac_sec_policy_name

string

Имя политики безопасности MAC.

Связь с политикой безопасности управления доступом к среде передачи (MACsec).

port_id

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

Идентификатор порта, который нужно настроить как восходящий порт Ethernet.

Это может быть обычный порт (например, 14) или агрегированный порт (например, «49/1»).

state

string

Создать/обновить или удалить восходящий порт Ethernet.

Варианты:

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

user_label

string

Заданная пользователем метка порта.

Метка пользователя должна содержать от 0 до 128 буквенно-цифровых символов.

fc_port_mode

dictionary

Настройка режима портов Fibre Channel для диапазона портов.

Это преобразует порты Ethernet в порты Fibre Channel.

Для каждой политики допускается только одна конфигурация режима портов FC.

Используются диапазоны портов FC, зависящие от устройства (см. документацию по device_model).

Для UCS-FI-6536 и UCSX-S9108-100G параметр fc_port_mode не поддерживается.

Функции FC доступны только через порты с разделением каналов. Если указать этот параметр, он будет проигнорирован с предупреждением.

port_id_end

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

Идентификатор конечного порта для настройки режима FC.

Допустимые значения зависят от модели устройства и поддерживаемого диапазона FC.

Для UCS-FI-6454/64108 допустимы значения 4, 8, 12 или 16.

Для UCS-FI-6664 значение должно находиться в диапазоне 25–40.

Не применяется к UCS-FI-6536 и UCSX-S9108-100G (для FC используйте порты с разделением каналов).

port_id_start

integer

Идентификатор начального порта для настройки режима FC.

Для UCS-FI-6454/64108 значение должно быть равно 1 (минимальный номер порта FC).

Для UCS-FI-6664 значение должно быть равно 25 (минимальный номер порта FC).

Не применяется к UCS-FI-6536 и UCSX-S9108-100G (для FC используйте порты с разделением каналов).

По умолчанию: 1

state

string

Включить или отключить режим портов FC.

Варианты:

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

fc_storage_ports

list / elements=dictionary

Список конфигураций портов хранилища FC.

Порты хранилища FC используются для прямого подключения к хранилищу.

Для UCS-FI-6454, UCS-FI-64108 и UCS-FI-6664 требуется настройка fc_port_mode.

В UCS-FI-6536 и UCSX-S9108-100G используются порты FC с разделением каналов (настройка fc_port_mode не требуется).

admin_speed

string

Административная скорость порта FC.

Варианты:

• "8Gbps" ← (по умолчанию)
• "16Gbps"
• "32Gbps"

port_id

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

Идентификатор порта, который нужно настроить как порт хранилища FC.

Порт должен находиться в диапазоне режима портов FC.

Это может быть обычный порт (например, 2) или агрегированный порт FC с разделением каналов (например, «36/2»).

Для агрегированных портов базовый порт должен быть настроен для разделения каналов FC.

state

string

Создать/обновить или удалить порт хранилища FC.

Варианты:

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

user_label

string

Заданная пользователем метка порта.

Метка пользователя должна содержать от 0 до 128 буквенно-цифровых символов.

vsan_id

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

Идентификатор VSAN, связанный с портом хранилища FC.

fc_uplink_port_channels

list / elements=dictionary

Список конфигураций восходящих каналов портов FC.

Каналы портов объединяют несколько портов FC в один логический канал.

Применяется только при настроенном параметре fc_port_mode.

admin_speed

string

Административная скорость канала портов FC.

Варианты:

• "8Gbps"
• "16Gbps" ← (по умолчанию)
• "32Gbps"

pc_id

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

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

Допустимый диапазон: 1–256.

ports

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

Список портов FC, включаемых в канал портов.

Порты должны находиться в диапазоне режима портов FC.

port_id

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

Идентификатор порта FC, включаемого в канал портов.

state

string

Создать/обновить или удалить канал портов.

Варианты:

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

user_label

string

Заданная пользователем метка канала портов.

Метка пользователя должна содержать от 0 до 128 буквенно-цифровых символов.

vsan_id

integer

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

По умолчанию: 1

fc_uplink_ports

list / elements=dictionary

Список конфигураций восходящих портов FC.

Восходящие порты FC используются для подключения к сетям хранения данных по Fibre Channel.

Для UCS-FI-6454, UCS-FI-64108 и UCS-FI-6664 требуется настройка fc_port_mode.

В UCS-FI-6536 и UCSX-S9108-100G используются порты FC с разделением каналов (настройка fc_port_mode не требуется).

admin_speed

string

Административная скорость порта FC.

Варианты:

• "Auto" ← (по умолчанию)
• "8Gbps"
• "16Gbps"
• "32Gbps"

port_id

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

Идентификатор порта, который нужно настроить как восходящий порт FC.

Порт должен находиться в диапазоне режима портов FC.

Это может быть обычный порт (например, 1) или агрегированный порт FC с разделением каналов (например, «36/1»).

Для агрегированных портов базовый порт должен быть настроен для разделения каналов FC.

state

string

Создать/обновить или удалить восходящий порт FC.

Варианты:

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

user_label

string

Заданная пользователем метка порта.

Метка пользователя должна содержать от 0 до 128 буквенно-цифровых символов.

vsan_id

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

Идентификатор виртуальной SAN, связанный с портом FC.

fcoe_uplink_port_channels

list / elements=dictionary

Список конфигураций восходящих каналов портов FCoE.

Каналы портов обеспечивают подключение Fibre Channel over Ethernet.

admin_speed

string

Административная скорость канала портов.

Варианты:

• "Auto" ← (по умолчанию)
• "1Gbps"
• "10Gbps"
• "25Gbps"
• "40Gbps"
• "100Gbps"

fec

string

Режим коррекции ошибок при передаче (FEC).

Варианты:

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

link_aggregation_policy_name

string

Имя связываемой политики агрегации каналов.

Связь с политикой агрегации каналов.

link_control_policy_name

string

Имя связываемой политики управления каналом.

pc_id

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

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

Допустимый диапазон: 1–256.

ports

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

Список портов Ethernet, включаемых в канал портов.

port_id

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

Идентификатор порта, включаемого в канал портов.

Это может быть обычный порт (например, 36) или агрегированный порт (например, «49/2»).

Для агрегированных портов используется синтаксис портов с разделением каналов: «49/2» означает подпорт 2 порта 49.

state

string

Создать/обновить или удалить канал портов.

Варианты:

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

user_label

string

Заданная пользователем метка канала портов.

Метка пользователя должна содержать от 0 до 128 буквенно-цифровых символов.

fcoe_uplink_ports

list / elements=dictionary

Список конфигураций восходящих портов FCoE.

Восходящие порты FCoE обеспечивают подключение Fibre Channel over Ethernet.

admin_speed

string

Административная скорость порта.

Варианты:

• "Auto" ← (по умолчанию)
• "1Gbps"
• "10Gbps"
• "25Gbps"
• "40Gbps"
• "100Gbps"

fec

string

Режим коррекции ошибок при передаче (FEC).

Варианты:

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

link_control_policy_name

string

Имя политики управления каналом.

port_id

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

Идентификатор порта, который нужно настроить как восходящий порт FCoE.

Это может быть обычный порт (например, 15) или агрегированный порт (например, «49/1»).

state

string

Создать/обновить или удалить восходящий порт FCoE.

Варианты:

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

user_label

string

Заданная пользователем метка порта.

Метка пользователя должна содержать от 0 до 128 буквенно-цифровых символов.

name

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

Имя, присвоенное политике портов.

Имя должно быть уникальным в пределах организации.

Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_.

organization

string

Имя организации, которой назначен этот ресурс.

Политики, созданные в пользовательской организации, применяются только к устройствам, входящим в ту же организацию.

Для организации по умолчанию используйте «default».

По умолчанию: "default"

pin_groups

list / elements=dictionary

Список конфигураций групп привязки (LAN и SAN).

Группы привязки управляют распределением трафика по восходящим каналам.

Группы привязки LAN используются для восходящих портов Ethernet и порт-каналов.

Группы привязки SAN используются для восходящих портов FCoE и порт-каналов.

name

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

Имя группы привязки.

pin_group_type

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

Тип группы привязки.

Используйте «lan» для восходящих портов Ethernet и порт-каналов.

Используйте «san» для восходящих портов FCoE и порт-каналов.

Варианты:

• "lan"
• "san"

state

string

Создать/обновить или удалить группу привязки.

Варианты:

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

target_interface_name

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

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

Для pc это должен быть pc_id восходящего порт-канала.

Для port это должен быть идентификатор порта (например, «14» или «49/1»).

target_interface_type

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

Тип целевого интерфейса.

Варианты:

• "pc"
• "port"

server_ports

list / elements=dictionary

Список конфигураций портов сервера.

Порты сервера подключаются к адаптерам сервера.

fec

string

Режим коррекции ошибок при передаче (FEC).

Варианты:

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

manual_numbering

boolean

Включить ручную нумерацию порта.

Если значение равно true, для preferred_device_type по умолчанию устанавливается «Chassis», а параметр preferred_device_id становится обязательным.

Значение не может быть true для агрегированных портов (например, «49/1»), поскольку ручная нумерация не поддерживается для портов с разбиением на подчинённые порты.

Нумерация шасси и стоечных серверов автоматически выполняется по мере их обнаружения.

Шасси нумеруются отдельно от стоечных серверов. Включите этот параметр, чтобы вручную задавать идентификаторы обнаруженных устройств.

Варианты:

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

port_id

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

Идентификатор порта, который нужно настроить как порт сервера.

Это может быть обычный порт (например, 49) или агрегированный порт (например, «49/2»).

Для агрегированных портов используется синтаксис портов с разбиением: «49/2» означает подчинённый порт 2 порта 49.

preferred_device_id

integer

Предпочтительный идентификатор устройства, если включена ручная нумерация шасси/сервера.

Обязателен, если manual_numbering имеет значение true или указан preferred_device_type.

preferred_device_type

string

Предпочтительный тип устройства, если включена ручная нумерация шасси/сервера.

Если manual_numbering имеет значение true, по умолчанию используется «Chassis».

Варианты:

• "Chassis"
• "RackServer"

state

string

Создать/обновить или удалить конфигурацию порта сервера.

Варианты:

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

user_label

string

Метка порта, заданная пользователем.

Метка пользователя должна содержать от 0 до 128 буквенно-цифровых символов.

state

string

Если present, будет проверено наличие ресурса и при необходимости он будет создан.

Если absent, будет проверено отсутствие ресурса и при необходимости он будет удалён.

Варианты:

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

tags

list / elements=dictionary

Список тегов в формате Key:<ключ, заданный пользователем> Value:<значение, заданное пользователем>.

use_proxy

boolean

Если no, прокси использоваться не будет, даже если он задан в переменной окружения на целевых хостах.

Варианты:

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

validate_certs

boolean

Логический параметр для проверки TLS-сертификата api_uri

Варианты:

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

api_response

dictionary

Выходные данные ответа API, возвращённые указанным ресурсом.

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

Пример: {"api_response": {"BreakoutPorts": [{"CustomMode": "BreakoutEthernet25G", "PortIdEnd": 49, "PortIdStart": 49, "SlotId": 1}], "DeviceModel": "UCS-FI-6454", "Name": "port-policy-example", "ObjectType": "fabric.PortPolicy", "ServerPorts": [{"Fec": "Auto", "PortId": 1, "SlotId": 1, "UserLabel": "Server Port 1"}], "Tags": [{"Key": "Environment", "Value": "Production"}]}}