модуль cisco.intersight.intersight_system_qos_policy — настройка политики QoS системы для 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"

classes

list / элементы=dictionary

Список классов QoS, настроенных в политике.

Система включает предопределённые классы (Bronze, Silver, Gold, Platinum, Best Effort, FC).

Классы Best Effort и FC всегда включены; на изменение их параметров распространяются ограничения.

admin_state

string

Административное состояние класса QoS.

Классы Best Effort и FC всегда включены.

Классы Bronze, Silver, Gold и Platinum по умолчанию отключены, если не указано иное.

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

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

• "Enabled"
• "Disabled"

cos

integer

Класс обслуживания, назначаемый трафику с этой меткой QoS.

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

Значение по умолчанию для класса FC — 3.

Значения по умолчанию: для Bronze — 1, Silver — 2, Gold — 4, Platinum — 5.

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

mtu

integer

Максимальный размер блока передачи (MTU) — это наибольший размер пакета или кадра, который можно передать в сети с передачей пакетов или кадров, например в Интернете.

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

Значение Normal (по умолчанию) соответствует 1500, FC — 2240.

Значение по умолчанию для класса FC — 2240, для остальных классов — 1500.

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

name

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

Имя класса QoS.

Допустимые имена классов: Bronze, Silver, Gold, Platinum, Best Effort, FC.

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

• "Bronze"
• "Silver"
• "Gold"
• "Platinum"
• "Best Effort"
• "FC"

packet_drop

boolean

Если параметр включён, этот класс QoS допускает потерю пакетов в пределах допустимого уровня.

Для класса FC по умолчанию задано значение false (потеря пакетов отключена).

Для всех остальных классов по умолчанию задано значение true (потеря пакетов включена).

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

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

• false
• true

weight

integer

Вес класса QoS определяет распределение пропускной способности между классами QoS.

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

Значения по умолчанию: для Bronze — 7, Silver — 8, Gold — 9, Platinum — 10, Best Effort и FC — 5.

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

description

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

string

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

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

name

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

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

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

organization

string

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

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

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

state

string

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

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

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

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

tags

list / элементы=dictionary

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

use_proxy

boolean

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

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

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

validate_certs

boolean

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

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

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

api_response

dictionary

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

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

Пример: {"Classes": [{"AdminState": "Enabled", "Cos": 1, "Mtu": 1500, "MulticastOptimize": false, "Name": "Bronze", "PacketDrop": true, "Weight": 7}], "Description": "System QoS policy for lab use", "Name": "lab-system-qos", "Organization": {"Moid": "675450ee69726530014753e2", "ObjectType": "organization.Organization"}}