модуль cisco.intersight.intersight_lan_connectivity_policy — управление политиками подключения к LAN и vNIC для Cisco Intersight
Примечание
Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install cisco.intersight.
Чтобы использовать её в плейбуке, укажите: cisco.intersight.intersight_lan_connectivity_policy.
Обзор
- Создание, обновление и удаление политик подключения к LAN в Cisco Intersight.
- Управление отдельными vNIC в политиках подключения к LAN.
- Поддержка целевых платформ Standalone и FIAttached с различными параметрами конфигурации.
- Политики подключения к LAN определяют параметры сетевого подключения для профилей серверов.
- Дополнительные сведения см. в документации 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. По умолчанию: |
azure_qos_enabled boolean | Включить Azure QoS для политики подключения к LAN. Применимо только, если target_platform — ‘FIAttached’. Варианты:
|
description псевдонимы: descr string | Описание политики подключения к LAN, заданное пользователем. Описание может содержать буквы (a–z, A–Z), цифры (0–9), дефис (-), точку (.), двоеточие (:) или символ подчёркивания (_). |
iqn_allocation_type string | Тип выделения IQN для политики подключения к LAN. Применимо только, если target_platform — ‘FIAttached’. Варианты:
|
iqn_pool_name string | Связь с пулом iSCSI Qualified Name. Обязательный параметр, если iqn_allocation_type имеет значение ‘Pool’. Применимо только для целевой платформы FIAttached. |
name string / обязательный | Имя, присвоенное политике подключения к LAN. Должно быть уникальным в пределах организации. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_. |
organization string | Имя организации, которой назначен этот ресурс. Политики, созданные в пользовательской организации, применимы только к устройствам в той же организации. Для организации по умолчанию используйте ‘default’. По умолчанию: |
placement_mode string | Режим размещения для назначения vNIC. Применимо только, если target_platform — ‘FIAttached’. Варианты:
|
state string | Если Если Варианты:
|
static_iqn_name string | Заданный пользователем статический iSCSI Qualified Name (IQN), используемый в качестве идентификатора инициатора iSCSI vNIC в домене Fabric Interconnect. Обязательный параметр, если iqn_allocation_type имеет значение ‘Static’. Применимо только для целевой платформы FIAttached. |
tags list / элементы=dictionary | Список тегов в формате «Ключ:<ключ, заданный пользователем> Значение:<значение, заданное пользователем>». |
target_platform string | Тип платформы, для которой предназначена политика подключения к LAN. Standalone — для автономных серверов, FIAttached — для серверов, подключённых к межсоединению Fabric Interconnect. Варианты:
|
use_proxy boolean | Если Варианты:
|
validate_certs boolean | Управляет проверкой TLS-сертификата api_uri. Варианты:
|
vnics list / элементы=dictionary | Список vNIC, которые необходимо создать и подключить к политике подключения к LAN. Для каждой vNIC будут настроены указанные сетевые политики и политики адаптера. Обязательный параметр, если Для платформ Standalone и FIAttached необходимо указать как минимум одну vNIC. |
|
auto_pci_link boolean |
Включить или отключить автоматическое назначение PCI Link в двухканальном адаптере. Этот параметр применяется только к адаптерам серии 13xx VIC с поддержкой двух каналов. Если параметр включён, система определяет, на одном из PCI Link разместить vNIC/vHBA. Если параметр отключён, необходимо указать pci_link_assignment_mode. Применимо только для целевой платформы FIAttached, если auto_vnic_placement_enabled имеет значение false. Варианты:
|
|
auto_slot_id boolean |
Включить или отключить автоматическое назначение идентификатора слота VIC. Если параметр включён и на сервере установлен только один VIC, для всех vNIC будет выбран один и тот же VIC. Если параметр включён и на сервере установлено несколько VIC, vNIC/vHBA будут размещены на первом VIC. Если параметр отключён, необходимо указать placement_slot_id. Применимо только для целевой платформы FIAttached, если auto_vnic_placement_enabled имеет значение false. Варианты:
|
|
auto_vnic_placement_enabled boolean |
Включить автоматическое размещение vNIC для серверов FIAttached. Если параметр включён, размещение vNIC упрощается: достаточно указать идентификатор коммутатора. Если параметр отключён, доступно полное управление размещением, включая порядок, auto_slot_id и auto_pci_link. Применимо только для целевой платформы FIAttached. Варианты:
|
|
cdn_source string |
Источник CDN. Им может быть заданное пользователем значение или имя vNIC. Варианты:
|
|
cdn_value string |
Значение CDN, если cdn_source имеет значение ‘user’. |
|
connection_type string |
Тип подключения для vNIC. Варианты:
|
|
eth_adapter_policy_name string |
Связь с политикой Ethernet-адаптера. Обязательный параметр, если состояние vNIC — ‘present’. |
|
eth_network_policy_name string |
Связь с сетевой политикой Ethernet. Обязательный параметр, если состояние vNIC — ‘present’. |
|
eth_qos_policy_name string |
Связь с политикой Ethernet QoS. Обязательный параметр, если состояние vNIC — ‘present’. |
|
fabric_eth_network_control_policy_name string |
Связь с политикой управления сетью Fabric Ethernet. Обязательный параметр, если целевая платформа — FIAttached и состояние vNIC — ‘present’. Применимо только для целевой платформы FIAttached. |
|
fabric_eth_network_group_policy_name string |
Связь с политикой группы Fabric Ethernet. Обязательный параметр, если целевая платформа — FIAttached и состояние vNIC — ‘present’. Применимо только для целевой платформы FIAttached. |
|
failover_enabled boolean |
Включает автоматическое переключение vNIC на резервный Fabric Interconnect при сбое основного пути. Переключение поддерживается только адаптерами Cisco VIC, подключёнными к кластеру Fabric Interconnect. Применимо только для целевой платформы FIAttached. Варианты:
|
|
iscsi_boot_policy_name string |
Связь с политикой загрузки iSCSI. Применимо только для целевой платформы FIAttached. |
|
mac_address_type string |
Тип назначения MAC-адреса. Применимо только для целевой платформы FIAttached. Варианты:
|
|
mac_pool_name string |
Назначаемый пул MAC-адресов. Обязательный параметр, если mac_address_type имеет значение ‘pool’, а целевая платформа — FIAttached. Применимо только для целевой платформы FIAttached. |
|
name string / обязательный |
Имя vNIC. Должно быть уникальным в пределах политики подключения к LAN. |
|
order integer |
Порядок активации виртуального интерфейса. Порядок, назначенный интерфейсу, должен быть уникальным для всех интерфейсов Ethernet и Fibre Channel на каждом канале PCI адаптера VIC. Порядок должен начинаться с нуля; пропуски не допускаются. Максимальное значение порядка PCI ограничено количеством виртуальных интерфейсов (Ethernet и Fibre Channel) на каждом канале PCI адаптера VIC. У всех адаптеров VIC один канал PCI, кроме VIC 1340, VIC 1380 и VIC 1385, у которых их два. По умолчанию: |
|
pci_link integer |
Канал PCI, используемый для передачи данных виртуального интерфейса. Канал PCI применим только к отдельным моделям Cisco UCS VIC 1300 (UCSC-PCIE-C40Q-03, UCSB-MLOM-40G-03, UCSB-VIC-M83-8P), поддерживающим два канала PCI. Указанное значение игнорируется для любых других моделей VIC. Для FIAttached параметр обязателен, если pci_link_assignment_mode имеет значение ‘Custom’. Варианты:
|
|
pci_link_assignment_mode string |
Режим назначения канала PCI при отключённом auto_pci_link. Режим Custom позволяет вручную выбрать канал PCI с помощью параметра pci_link. Режим Load-Balanced автоматически распределяет vNIC по доступным каналам PCI. Обязательный параметр, если auto_pci_link имеет значение false и auto_vnic_placement_enabled имеет значение false. Применимо только для целевой платформы FIAttached. Варианты:
|
|
pin_group_name string |
Имя группы закрепления, связанной с vNIC для статического закрепления. При развёртывании LCP будет разрешено имя группы закрепления и получен соответствующий восходящий порт/канал портов для закрепления трафика vNIC. Применимо только для целевой платформы FIAttached. |
|
placement_slot_id string |
Слот PCIe, в который установлен адаптер VIC. Поддерживаемые значения: (1–15) и MLOM. Обязательный параметр, если состояние vNIC — ‘present’. |
|
sriov_settings dictionary |
Настройки SR-IOV при connection_type со значением ‘sriov’. |
|
comp_count_per_vf integer |
Количество очередей завершения на VF (1–16). По умолчанию: |
|
enabled boolean |
Включить SR-IOV. Варианты:
|
|
int_count_per_vf integer |
Количество прерываний на VF (1–16). По умолчанию: |
|
rx_count_per_vf integer |
Количество очередей приёма на VF (1–8). По умолчанию: |
|
tx_count_per_vf integer |
Количество очередей передачи на VF (1–8). По умолчанию: |
|
vf_count integer |
Количество виртуальных функций (1–64). По умолчанию: |
|
state string |
Создать/обновить или удалить vNIC. Варианты:
|
|
static_mac_address string |
MAC-адрес должен быть указан в шестнадцатеричном формате xx:xx:xx:xx:xx:xx. Чтобы обеспечить уникальность MAC-адресов в LAN-фабрике, настоятельно рекомендуется использовать следующий префикс MAC-адреса: 00:25:B5:xx:xx:xx. Обязателен, если mac_address_type имеет значение ‘static’, а целевая платформа — FIAttached. Применимо только для целевой платформы FIAttached. |
|
switch_id string |
Порт фабрики, с которым будут связаны vNIC. Применимо только для целевой платформы FIAttached. Варианты:
|
|
uplink_port integer |
Порт адаптера, на котором будет создан виртуальный интерфейс. Варианты:
|
|
usnic_settings dictionary |
Параметры USNIC, если connection_type имеет значение ‘usnic’. Обязателен, если connection_type имеет значение ‘usnic’. |
|
cos integer |
Класс обслуживания для трафика на usNIC. Варианты:
|
|
count integer |
Количество создаваемых интерфейсов usNIC. Если usNIC включен, допустимы значения от 1 до 225. Если usNIC отключен, значение по умолчанию равно 0. По умолчанию: |
|
usnic_adapter_policy_name string |
Политика Ethernet-адаптера, связанная с интерфейсами usNIC. Обязателен, если connection_type имеет значение ‘usnic’. |
|
vmq_settings dictionary |
Параметры VMQ, если connection_type имеет значение ‘vmq’. |
|
enabled boolean |
Включить VMQ. Варианты:
|
|
multi_queue_support boolean |
Включает функцию Virtual Machine Multi-Queue для виртуального интерфейса. VMMQ позволяет настроить несколько очередей ввода-вывода для одной виртуальной машины и, таким образом, распределять трафик между несколькими ядрами ЦП виртуальной машины. Варианты:
|
|
num_interrupts integer |
Количество выделяемых ресурсов прерываний. Рекомендуется указать количество потоков ЦП или логических процессоров, доступных на сервере. По умолчанию: |
|
num_sub_vnics integer |
Количество подчинённых vNIC (0–64). Применимо только, если multi_queue_support имеет значение true. По умолчанию: |
|
num_vmqs integer |
Количество выделяемых аппаратных очередей виртуальных машин. Количество VMQ на адаптер должно быть на единицу больше максимального количества сетевых интерфейсов виртуальных машин. По умолчанию: |
|
vmmq_adapter_policy_name string |
Имя политики адаптера VMMQ. Применимо только, если multi_queue_support имеет значение true. |
Примеры
- name: Create a LAN Connectivity Policy for Standalone servers
cisco.intersight.intersight_lan_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: "default"
name: "Standalone-lan-policy"
description: "LAN connectivity policy for Standalone servers"
target_platform: "Standalone"
tags:
- Key: "Environment"
Value: "Production"
- Key: "Site"
Value: "DataCenter-A"
vnics:
- name: "eth0"
placement_slot_id: "1"
pci_link: 0
uplink_port: 0
order: 0
eth_network_policy_name: "default-network-policy"
eth_qos_policy_name: "default-qos-policy"
eth_adapter_policy_name: "default-adapter-policy"
connection_type: "none"
- name: "eth1"
placement_slot_id: "2"
pci_link: 0
uplink_port: 1
order: 1
eth_network_policy_name: "vlan-network-policy"
eth_qos_policy_name: "high-qos-policy"
eth_adapter_policy_name: "performance-adapter-policy"
connection_type: "none"
state: present
- name: Create a LAN Connectivity Policy for FIAttached servers
cisco.intersight.intersight_lan_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: "default"
name: "fi-attached-lan-policy"
description: "LAN connectivity policy for FIAttached servers"
target_platform: "FIAttached"
azure_qos_enabled: true
iqn_allocation_type: "Pool"
iqn_pool_name: "default-iqn-pool"
placement_mode: "custom"
tags:
- Key: "Environment"
Value: "Production"
vnics:
- name: "vnic-fi-attached"
order: 0
cdn_source: "vnic"
mac_address_type: "pool"
mac_pool_name: "default-mac-pool"
auto_slot_id: true
auto_pci_link: true
auto_vnic_placement_enabled: false
switch_id: "A"
failover_enabled: false
fabric_eth_network_group_policy_name: "default-network-group"
fabric_eth_network_control_policy_name: "default-network-control"
eth_qos_policy_name: "default-qos-policy"
eth_adapter_policy_name: "default-adapter-policy"
connection_type: "none"
state: present
state: present
- name: Create a LAN Connectivity Policy with pin group for static pinning
cisco.intersight.intersight_lan_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: "default"
name: "fi-attached-pinned-policy"
description: "LAN connectivity policy with static uplink pinning"
target_platform: "FIAttached"
azure_qos_enabled: false
iqn_allocation_type: "None"
placement_mode: "custom"
vnics:
- name: "pinned-vnic"
order: 0
cdn_source: "vnic"
mac_address_type: "pool"
mac_pool_name: "default-mac-pool"
auto_slot_id: true
auto_pci_link: true
auto_vnic_placement_enabled: false
switch_id: "A"
failover_enabled: false
fabric_eth_network_group_policy_name: "default-network-group"
fabric_eth_network_control_policy_name: "default-network-control"
eth_qos_policy_name: "default-qos-policy"
eth_adapter_policy_name: "default-adapter-policy"
pin_group_name: "pingroup-a"
connection_type: "none"
state: present
state: present
- name: Create a LAN Connectivity Policy with automatic vNIC placement
cisco.intersight.intersight_lan_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: "default"
name: "fi-attached-auto-placement-policy"
description: "LAN connectivity policy with automatic vNIC placement"
target_platform: "FIAttached"
azure_qos_enabled: false
iqn_allocation_type: "None"
placement_mode: "auto"
vnics:
- name: "auto-placed-vnic"
cdn_source: "vnic"
mac_address_type: "pool"
mac_pool_name: "default-mac-pool"
auto_vnic_placement_enabled: true
switch_id: "A"
failover_enabled: false
fabric_eth_network_group_policy_name: "default-network-group"
fabric_eth_network_control_policy_name: "default-network-control"
eth_qos_policy_name: "default-qos-policy"
eth_adapter_policy_name: "default-adapter-policy"
connection_type: "none"
state: present
state: present
- name: Create a LAN Connectivity Policy with advanced placement control
cisco.intersight.intersight_lan_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: "default"
name: "fi-attached-advanced-placement-policy"
description: "LAN connectivity policy with advanced placement control"
target_platform: "FIAttached"
azure_qos_enabled: false
iqn_allocation_type: "None"
placement_mode: "custom"
vnics:
- name: "advanced-placed-vnic"
order: 9
cdn_source: "vnic"
mac_address_type: "pool"
mac_pool_name: "default-mac-pool"
auto_slot_id: false
placement_slot_id: "5"
auto_pci_link: false
pci_link_assignment_mode: "Custom"
pci_link: 0
auto_vnic_placement_enabled: false
switch_id: "A"
failover_enabled: false
fabric_eth_network_group_policy_name: "default-network-group"
fabric_eth_network_control_policy_name: "default-network-control"
eth_qos_policy_name: "default-qos-policy"
eth_adapter_policy_name: "default-adapter-policy"
connection_type: "none"
state: present
state: present
- name: Create a LAN Connectivity Policy with load-balanced PCI assignment
cisco.intersight.intersight_lan_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: "default"
name: "fi-attached-load-balanced-policy"
description: "LAN connectivity policy with load-balanced PCI assignment"
target_platform: "FIAttached"
azure_qos_enabled: false
iqn_allocation_type: "None"
placement_mode: "custom"
vnics:
- name: "load-balanced-vnic"
order: 5
cdn_source: "vnic"
mac_address_type: "pool"
mac_pool_name: "default-mac-pool"
auto_slot_id: false
placement_slot_id: "MLOM"
auto_pci_link: false
pci_link_assignment_mode: "Load-Balanced"
auto_vnic_placement_enabled: false
switch_id: "B"
failover_enabled: true
fabric_eth_network_group_policy_name: "default-network-group"
fabric_eth_network_control_policy_name: "default-network-control"
eth_qos_policy_name: "default-qos-policy"
eth_adapter_policy_name: "default-adapter-policy"
connection_type: "none"
state: present
state: present
- name: Create a LAN Connectivity Policy with USNIC vNIC
cisco.intersight.intersight_lan_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "usnic-lan-policy"
description: "Policy with USNIC configuration"
target_platform: "Standalone"
vnics:
- name: "usnic-eth0"
placement_slot_id: "4"
pci_link: 0
uplink_port: 0
order: 0
eth_network_policy_name: "hpc-network-policy"
eth_qos_policy_name: "hpc-qos-policy"
eth_adapter_policy_name: "hpc-adapter-policy"
connection_type: "usnic"
usnic_settings:
count: 0
cos: 5
usnic_adapter_policy_name: "hpc-adapter-policy"
state: present
- name: Create a LAN Connectivity Policy with VMQ vNIC
cisco.intersight.intersight_lan_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "vmq-lan-policy"
description: "Policy with VMQ configuration"
target_platform: "Standalone"
vnics:
- name: "vmq-eth0"
placement_slot_id: "10"
pci_link: 0
uplink_port: 2
order: 0
eth_network_policy_name: "vm-network-policy"
eth_qos_policy_name: "vm-qos-policy"
eth_adapter_policy_name: "vm-adapter-policy"
connection_type: "vmq"
vmq_settings:
enabled: true
multi_queue_support: false
num_interrupts: 16
num_vmqs: 4
state: present
- name: Create a LAN Connectivity Policy with VMQ multi-queue support
cisco.intersight.intersight_lan_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "vmq-multiqueue-lan-policy"
description: "Policy with VMQ multi-queue configuration"
target_platform: "Standalone"
vnics:
- name: "vmq-mq-eth0"
placement_slot_id: "11"
pci_link: 1
uplink_port: 3
order: 0
eth_network_policy_name: "vm-network-policy"
eth_qos_policy_name: "vm-qos-policy"
eth_adapter_policy_name: "vm-adapter-policy"
connection_type: "vmq"
vmq_settings:
enabled: true
multi_queue_support: true
num_sub_vnics: 64
vmmq_adapter_policy_name: "vmmq-adapter-policy"
state: present
- name: Create a LAN Connectivity Policy with SR-IOV vNIC
cisco.intersight.intersight_lan_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "sriov-lan-policy"
description: "Policy with SR-IOV configuration"
target_platform: "Standalone"
vnics:
- name: "sriov-eth0"
placement_slot_id: "14"
pci_link: 0
uplink_port: 1
order: 0
eth_network_policy_name: "sriov-network-policy"
eth_qos_policy_name: "sriov-qos-policy"
eth_adapter_policy_name: "sriov-adapter-policy"
connection_type: "sriov"
sriov_settings:
enabled: true
vf_count: 64
rx_count_per_vf: 4
tx_count_per_vf: 1
comp_count_per_vf: 5
int_count_per_vf: 8
state: present
- name: Create a LAN Connectivity Policy with custom CDN values
cisco.intersight.intersight_lan_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "custom-cdn-lan-policy"
description: "Policy with custom CDN values"
target_platform: "Standalone"
vnics:
- name: "mgmt-nic"
placement_slot_id: "1"
pci_link: 0
uplink_port: 0
order: 0
cdn_source: "user"
cdn_value: "Management-NIC"
eth_network_policy_name: "mgmt-network-policy"
eth_qos_policy_name: "mgmt-qos-policy"
eth_adapter_policy_name: "mgmt-adapter-policy"
connection_type: "none"
state: present
- name: Update LAN connectivity policy - manage vNIC states
cisco.intersight.intersight_lan_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: "default"
name: "mixed-vnic-states-policy"
description: "Policy demonstrating vNIC state management"
target_platform: "Standalone"
vnics:
- name: "eth0"
placement_slot_id: "1"
pci_link: 0
uplink_port: 0
order: 0
eth_network_policy_name: "production-network"
eth_qos_policy_name: "standard-qos"
eth_adapter_policy_name: "standard-adapter"
connection_type: "none"
state: present
- name: "eth1-old"
state: absent
- name: "eth2-new"
placement_slot_id: "3"
pci_link: 0
uplink_port: 1
order: 1
eth_network_policy_name: "production-network"
eth_qos_policy_name: "standard-qos"
eth_adapter_policy_name: "standard-adapter"
connection_type: "vmq"
vmq_settings:
enabled: true
multi_queue_support: false
num_interrupts: 16
num_vmqs: 4
state: present
state: present
- name: Delete a LAN Connectivity Policy
cisco.intersight.intersight_lan_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "old-lan-policy"
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
api_response dictionary | Выходные данные ответа API, возвращённые указанным ресурсом. Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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/cisco/intersight/intersight_lan_connectivity_policy_module.html