Модуль cisco.intersight.intersight_fibre_channel_adapter_policy — управление политиками адаптеров Fibre Channel для 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

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

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

error_detection_timeout

integer

Тайм-аут обнаружения ошибки (Error Detection Timeout), также называемый EDTOV, — время ожидания в миллисекундах.

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

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

error_recovery_enabled

boolean

Включает восстановление после ошибок Fibre Channel.

Варианты:

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

flogi_retries

integer

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

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

flogi_timeout

integer

Время в миллисекундах, которое система ждёт перед повторной попыткой входа.

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

interrupt_mode

string

Предпочтительный режим прерываний драйвера.

Рекомендуется использовать MSIx.

Варианты:

• "MSIx" ← (по умолчанию)
• "MSI"
• "INTx"

io_retry_timeout

integer

Количество секунд, в течение которых адаптер ждёт перед отменой ожидающей команды.

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

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

io_throttle_count

integer

Максимальное количество операций ввода-вывода данных или управления, которые могут одновременно ожидать выполнения для виртуального интерфейса.

Если это значение превышено, дополнительные операции ввода-вывода ожидают в очереди.

Они ожидают, пока количество ожидающих операций ввода-вывода не уменьшится и дополнительные операции не смогут быть обработаны.

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

link_down_timeout

integer

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

По истечении этого тайм-аута соединение с фабрикой считается потерянным.

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

lun_count

integer

Максимальное количество LUN, которые драйвер Fibre Channel будет экспортировать или отображать.

Максимальное количество LUN обычно ограничивается операционной системой, работающей на сервере.

Значение количества LUN может превышать 1024 только для vHBA типа ‘FC Initiator’ и на серверах с поддерживаемой версией микропрограммы.

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

lun_queue_depth

integer

Количество команд, которые HBA может отправить и получить за одну передачу для каждого LUN.

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

name

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

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

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

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

organization

string

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

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

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

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

plogi_retries

integer

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

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

plogi_timeout

integer

Время в миллисекундах, которое система ждёт перед повторной попыткой входа.

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

port_down_io_retry_count

integer

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

После этого количества попыток система считает порт недоступным.

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

port_down_timeout

integer

Время в миллисекундах, в течение которого удалённый порт Fibre Channel должен оставаться отключённым, прежде чем об этом будет сообщено верхнему уровню SCSI.

Этот параметр определяет, когда порт считается недоступным.

Для сервера с адаптером VIC под управлением ESXi рекомендуется значение 10000.

Для сервера с портом, используемым для загрузки Windows из SAN, рекомендуется значение 5000 миллисекунд.

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

resource_allocation_timeout

integer

Тайм-аут выделения ресурсов (Resource Allocation Timeout), также называемый RATOV, — время ожидания в миллисекундах.

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

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

rx_ring_size

integer

Количество дескрипторов в каждой очереди приёма.

Максимальное значение для очереди приёма — 2048.

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

scsi_io_queue_count

integer

Количество ресурсов очередей ввода-вывода SCSI, которое должна выделить система.

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

scsi_io_ring_size

integer

Количество дескрипторов в каждой очереди ввода-вывода SCSI.

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

state

string

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

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

Варианты:

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

tags

list / elements=dictionary

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

tx_ring_size

integer

Количество дескрипторов в каждой очереди передачи.

Максимальное значение для очереди передачи — 128.

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

use_proxy

boolean

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

Варианты:

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

validate_certs

boolean

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

Варианты:

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

api_response

dictionary

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

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

Пример: {"api_response": {"Description": "Fibre Channel Adapter policy with default values", "ErrorDetectionTimeout": 2000, "ErrorRecoverySettings": {"Enabled": false, "IoRetryCount": 8, "IoRetryTimeout": 5, "LinkDownTimeout": 30000, "PortDownTimeout": 10000}, "FlogiSettings": {"Retries": 8, "Timeout": 4000}, "InterruptSettings": {"Mode": "MSIx"}, "IoThrottleCount": 512, "LunCount": 1024, "LunQueueDepth": 20, "Moid": "1234567890abcdef12345678", "Name": "fc-adapter-default", "ObjectType": "vnic.FcAdapterPolicy", "Organization": {"Moid": "abcdef1234567890abcdef12", "ObjectType": "organization.Organization"}, "PlogiSettings": {"Retries": 8, "Timeout": 20000}, "ResourceAllocationTimeout": 10000, "RxQueueSettings": {"RingSize": 64}, "ScsiQueueSettings": {"Count": 1, "RingSize": 512}, "Tags": [{"Key": "Environment", "Value": "Production"}], "TxQueueSettings": {"RingSize": 64}}}