Модуль cisco.intersight.intersight_ethernet_qos_policy — настройка политики QoS Ethernet для Cisco Intersight

Примечание

Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install cisco.intersight.

Чтобы использовать её в плейбуке, укажите: cisco.intersight.intersight_ethernet_qos_policy.

Описание
Параметры
Примеры
Возвращаемые значения

Описание

Управляет настройкой политики QoS Ethernet в Cisco Intersight.
Политика для настройки параметров качества обслуживания виртуальных интерфейсов Ethernet на серверах, управляемых Cisco Intersight.
Дополнительную информацию см. в разделе Cisco Intersight.

Параметры

Параметр	Комментарии
api_key_id строка / обязательный	Идентификатор открытого ключа API, связанного с закрытым ключом. Если параметр не задан, используется значение переменной среды INTERSIGHT_API_KEY_ID.
api_private_key путь / обязательный	Имя файла (абсолютный путь) или строка с данными закрытого ключа в формате 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 строка	URI для доступа к API Intersight. Если параметр не задан, используется значение переменной среды INTERSIGHT_API_URI. По умолчанию: `"https://intersight.com/api/v1"`
burst целое число	Допустимый для vNIC всплесковый трафик в байтах. Допустимый диапазон: от 1 до 1000000. По умолчанию: `10240`
cos целое число	Класс обслуживания, назначаемый трафику виртуального интерфейса. Допустимый диапазон: 0–6. По умолчанию: `0`
description псевдонимы: descr строка	Описание политики QoS Ethernet, заданное пользователем. Описание может содержать буквы (a–z, A–Z), цифры (0–9), дефис (-), точку (.), двоеточие (:) или подчёркивание (_).
mtu целое число	Максимальный размер передаваемого блока (MTU), или размер пакета, принимаемого виртуальным интерфейсом. Допустимый диапазон: 1500–9000. По умолчанию: `1500`
name строка / обязательный	Имя, присвоенное политике QoS Ethernet. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_.
organization строка	Имя организации, которой назначен этот ресурс. Профили, политики и пулы, созданные в пользовательской организации, применимы только к устройствам в той же организации. По умолчанию: `"default"`
priority строка	Приоритет, соответствующий QoS системы, заданному в профиле фабрики. Варианты: `"Best Effort"` ← (по умолчанию) `"FC"` `"Platinum"` `"Gold"` `"Silver"` `"Bronze"`
rate_limit целое число	Значение в Мбит/с (0–10G/40G/100G в зависимости от модели адаптера), используемое для ограничения скорости передачи данных на виртуальном интерфейсе. Диапазон значений: от 0 до 100000. По умолчанию: `0`
state строка	Если задано значение `present`, модуль проверит наличие ресурса и при необходимости создаст его. Если задано значение `absent`, модуль проверит отсутствие ресурса и при необходимости удалит его. Варианты: `"present"` ← (по умолчанию) `"absent"`
tags список / элементы=словарь	Список тегов в формате «ключ: <заданный пользователем ключ>, значение: <заданное пользователем значение>».
trust_host_cos логический	Разрешает использовать класс обслуживания, предоставляемый операционной системой. Варианты: `false` ← (по умолчанию) `true`
use_proxy логический	Если задано значение `no`, прокси-сервер использоваться не будет, даже если он указан в переменной среды на целевых узлах. Варианты: `false` `true` ← (по умолчанию)
validate_certs логический	Логический параметр для проверки TLS-сертификата api_uri. Варианты: `false` `true` ← (по умолчанию)

Примеры

- name: Create an Ethernet QoS Policy with default settings
  cisco.intersight.intersight_ethernet_qos_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "default-qos-policy"
    description: "Default Ethernet QoS policy"
    state: present

- name: Create an Ethernet QoS Policy with Platinum priority and trust host CoS
  cisco.intersight.intersight_ethernet_qos_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "platinum-qos-policy"
    description: "High priority Ethernet QoS policy"
    tags:
      - Key: "Environment"
        Value: "Production"
    mtu: 9000
    cos: 5
    priority: "Platinum"
    trust_host_cos: true
    rate_limit: 10000
    burst: 100000
    state: present

- name: Create an Ethernet QoS Policy with custom settings
  cisco.intersight.intersight_ethernet_qos_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "custom-qos-policy"
    description: "Custom Ethernet QoS policy for specific workload"
    mtu: 1500
    cos: 3
    priority: "Gold"
    trust_host_cos: false
    rate_limit: 5000
    burst: 50000
    state: present

- name: Delete an Ethernet QoS Policy
  cisco.intersight.intersight_ethernet_qos_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "custom-qos-policy"
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
api_response словарь	Ответ API, возвращаемый указанным ресурсом. Возвращается: всегда Пример: `{"api_response": {"Burst": 100000, "Cos": 5, "Mtu": 9000, "Name": "platinum-qos-policy", "ObjectType": "vnic.EthQosPolicy", "Priority": "Platinum", "RateLimit": 10000, "Tags": [{"Key": "Environment", "Value": "Production"}], "TrustHostCos": true}}`

Авторы

Ron Gershburg (@rgershbu)

Ссылки на коллекцию

© 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_ethernet_qos_policy_module.html