Модуль cisco.intersight.intersight_san_connectivity_policy — управление политиками подключения SAN и vHBA для 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"

description

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

string

Описание политики подключения SAN, заданное пользователем.

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

name

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

Имя, назначенное политике подключения SAN.

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

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

organization

string

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

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

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

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

placement_mode

string

Режим размещения vHBA на сетевых адаптерах.

custom требует указать размещение вручную для каждого vHBA.

auto автоматически распределяет vHBA между адаптерами при развертывании профиля.

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

Варианты:

• "custom" ← (по умолчанию)
• "auto"

state

string

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

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

Варианты:

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

static_wwnn_address

string

Адрес WWNN узла сервера должен быть указан в шестнадцатеричном формате xx:xx:xx:xx:xx:xx:xx:xx.

Допустимые диапазоны: от 20:00:00:00:00:00:00:00 до 20:FF:FF:FF:FF:FF:FF:FF или от 50:00:00:00:00:00:00:00 до 5F:FF:FF:FF:FF:FF:FF:FF.

Чтобы обеспечить уникальность WWN в фабрике SAN, настоятельно рекомендуется использовать префикс WWN 20:00:00:25:B5:xx:xx:xx.

Обязателен, если wwnn_address_type имеет значение static, а целевая платформа — FIAttached.

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

tags

list / elements=dictionary

Список тегов в формате «Ключ:<заданный пользователем ключ> Значение:<заданное пользователем значение>».

target_platform

string

Тип платформы, для которой предназначена политика подключения SAN.

Standalone для автономных серверов.

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

Примечание: политики подключения SAN не поддерживаются на серверах Unified Edge.

Варианты:

• "Standalone" ← (по умолчанию)
• "FIAttached"

use_proxy

boolean

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

Варианты:

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

validate_certs

boolean

Логическое значение, определяющее, следует ли проверять TLS-сертификат api_uri.

Варианты:

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

vhbas

list / elements=dictionary

Список vHBA, которые нужно создать и подключить к политике подключения SAN.

Для каждого vHBA будут настроены указанные политики Fibre Channel.

Параметры конфигурации зависят от значения target_platform.

auto_pci_link

boolean

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

Этот параметр применяется только к VIC серии 13xx с поддержкой двух каналов.

Если параметр включен, система определяет, на каком из каналов PCI разместить vHBA.

Если параметр отключен, необходимо указать pci_link_assignment_mode.

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

Варианты:

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

auto_slot_id

boolean

Включение или отключение автоматического назначения идентификатора слота VIC.

Если параметр включен и сервер оснащен только одним VIC, для всех vHBA выбирается один и тот же VIC.

Если параметр включен и сервер оснащен несколькими VIC, vHBA развертывается на первом VIC.

Если параметр отключен, необходимо указать slot_id.

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

Варианты:

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

fibre_channel_adapter_policy

string

Имя политики адаптера Fibre Channel.

Обязательно, если состояние vHBA — present.

fibre_channel_network_policy

string

Имя сетевой политики Fibre Channel.

Обязательно, если состояние vHBA — present.

fibre_channel_qos_policy

string

Имя политики QoS Fibre Channel.

Обязательно, если состояние vHBA — present.

fibre_channel_zone_policies

list / elements=string

Список имен политик зон Fibre Channel.

Связь с политикой зон FC используется для настройки зон на коммутаторе.

Необязательное поле для целевой платформы FIAttached.

name

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

Имя виртуального интерфейса Fibre Channel.

Должно быть уникальным в пределах политики подключения SAN.

pci_link

integer

Канал PCI, используемый для передачи данных виртуального интерфейса.

Канал PCI применим только к некоторым моделям Cisco UCS VIC 1300 (UCSC-PCIE-C40Q-03, UCSB-MLOM-40G-03, UCSB-VIC-M83-8P), поддерживающим два канала PCI.

Указанное значение будет проигнорировано для любой другой модели VIC.

Для Standalone используется непосредственно.

Для FIAttached обязателен, если pci_link_assignment_mode имеет значение Custom.

Варианты:

• 0 ← (по умолчанию)
• 1

pci_link_assignment_mode

string

Режим назначения канала PCI, если auto_pci_link отключен.

custom позволяет вручную выбрать канал PCI с помощью параметра pci_link.

load-balanced автоматически распределяет vHBA по доступным каналам PCI.

Обязателен, если auto_pci_link имеет значение false.

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

Варианты:

• "custom"
• "load-balanced"

pci_order

integer

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

Порядок, назначенный интерфейсу, должен быть уникальным для всех интерфейсов Ethernet и Fibre Channel на каждом канале PCI адаптера VIC.

Порядок должен начинаться с нуля, значения не должны пересекаться.

Максимальное значение порядка PCI ограничено количеством виртуальных интерфейсов (Ethernet и Fibre Channel) на каждом канале PCI адаптера VIC.

У всех адаптеров VIC один канал PCI, за исключением VIC 1340, VIC 1380 и VIC 1385, у которых их два.

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

persistent_lun_bindings

boolean

Включает сохранение сопоставлений идентификаторов LUN в памяти до их ручной очистки.

Варианты:

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

pin_group_name

string

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

При развертывании SCP будет разрешено имя группы закрепления и получен соответствующий порт восходящего канала или агрегированный канал для закрепления трафика vHBA.

Необязательное поле для целевой платформы FIAttached.

slot_id

string

Слот PCIe, в который установлен адаптер VIC.

Допустимые значения: (1–15) и MLOM.

Обязателен для Standalone, если состояние vHBA — present.

Обязателен для FIAttached, если состояние vHBA — present, а auto_slot_id имеет значение false.

state

string

Определяет, следует ли создать или обновить vHBA либо удалить его.

Варианты:

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

static_wwpn_address

string

Адрес WWPN должен быть указан в шестнадцатеричном формате xx:xx:xx:xx:xx:xx:xx:xx.

Допустимые диапазоны: от 20:00:00:00:00:00:00:00 до 20:FF:FF:FF:FF:FF:FF:FF или от 50:00:00:00:00:00:00:00 до 5F:FF:FF:FF:FF:FF:FF:FF.

Чтобы обеспечить уникальность WWN в фабрике SAN, настоятельно рекомендуется использовать префикс WWN 20:00:00:25:B5:xx:xx:xx.

Обязателен, если wwpn_address_type имеет значение static, а целевая платформа — FIAttached.

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

switch_id

string

Порт фабрики, с которым будет связан vHBA.

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

Варианты:

• "a" ← (по умолчанию)
• "b"

uplink_port

integer

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

Применимо только для платформы Standalone.

Варианты:

• 0 ← (по умолчанию)
• 1
• 2
• 3

vhba_type

string

Настройка типа vHBA для политики подключения SAN.

Эта конфигурация поддерживается только адаптерами Cisco VIC серии 14XX и более поздних серий.

Обязательно, если состояние vHBA — present.

Варианты:

• "fc-initiator"
• "fc-nvme-initiator"
• "fc-nvme-target"
• "fc-target"

wwpn_address_type

string

Тип назначения адреса WWPN.

pool для использования пула WWPN.

static для назначения статического адреса WWPN вручную.

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

Варианты:

• "pool" ← (по умолчанию)
• "static"

wwpn_pool

string

Пул WWPN, используемый для назначения адреса WWPN интерфейсу vHBA.

Обязателен, если wwpn_address_type имеет значение pool, а целевая платформа — FIAttached.

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

wwnn_address_type

string

Тип назначения адреса WWNN.

pool для использования пула WWNN.

static для назначения статического адреса WWNN вручную.

Применимо только, если target_platform имеет значение FIAttached.

Варианты:

• "pool" ← (по умолчанию)
• "static"

wwnn_pool

string

Пул WWNN, назначаемый для выделения адреса WWNN.

Обязателен, если wwnn_address_type имеет значение pool, а целевая платформа — FIAttached.

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

api_response

dictionary

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

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

Пример: {"api_response": {"Name": "fi-attached-san-policy", "ObjectType": "vnic.SanConnectivityPolicy", "Tags": [{"Key": "Environment", "Value": "Production"}], "TargetPlatform": "FIAttached", "WwnnAddressType": "POOL", "vHBAs": [{"Name": "vhba-a", "ObjectType": "vnic.FcIf", "Order": 0, "Placement": {"AutoPciLink": true, "AutoSlotId": true, "SwitchId": "A"}, "Type": "fc-initiator"}]}}