dellemc.enterprise_sonic.sonic_qos_wred 模块 – 管理 SONiC 上的 QoS WRED 配置文件配置

注意

此模块是 dellemc.enterprise_sonic 集合（版本 2.5.1）的一部分。

如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install dellemc.enterprise_sonic。

要在 playbook 中使用它，请指定：dellemc.enterprise_sonic.sonic_qos_wred。

dellemc.enterprise_sonic 2.5.0 中的新增功能

概要 

此模块提供对运行 SONiC 的设备的 QoS WRED 配置文件的配置管理

参数 

参数	注释
config 列表 / 元素=字典	QoS WRED 配置文件配置
ecn 字符串	有色数据包的 ECN 设置选择 `"green"`
green 字典	绿色数据包的 WRED 配置
drop_probability 整数	绿色数据包的丢包概率百分比率范围 0-100
enable 布尔值	启用或禁用绿色数据包的 WRED 选择 `false` `true`
max_threshold 整数	以字节为单位为绿色数据包设置的最大阈值范围 1000-12480000
min_threshold 整数	以字节为单位为绿色数据包设置的最小阈值范围 1000-12480000
name 字符串 / 必需	WRED 配置文件的名称
state 字符串	模块完成后配置的状态。选择 `"merged"` ←（默认） `"deleted"` `"overridden"` `"replaced"`

注释 

注意

已针对 Dell Technologies 的 Enterprise SONiC 发行版进行测试。
支持 check_mode。

示例 

# Using Merged
#
# Before state:
# -------------
#
# sonic# show qos wred-policy
# (No qos wred-policy configuration present)

- name: Merge QoS WRED policy configuration
  dellemc.enterprise_sonic.sonic_qos_wred:
    config:
      - name: profile1
        ecn: green
        green:
          enable: True
          min_threshold: 1000
          max_threshold: 5000
          drop_probability: 25
    state: merged

# After state:
# ------------
#
# sonic# show qos wred-policy
# ---------------------------------------------------
# Policy                 : profile1
# ---------------------------------------------------
# ecn                    : ecn_green
# green-min-threshold    : 1           KBytes
# green-max-threshold    : 5           KBytes
# green-drop-probability : 25
#
#
# Using Replaced
#
# Before state:
# -------------
#
# sonic# show qos wred-policy
# ---------------------------------------------------
# Policy                 : profile1
# ---------------------------------------------------
# ecn                    : ecn_green
# green-min-threshold    : 1           KBytes
# green-max-threshold    : 5           KBytes
# green-drop-probability : 25

- name: Replace QoS WRED policy configuration
  dellemc.enterprise_sonic.sonic_qos_wred:
    config:
      - name: profile1
        green:
          drop_probability: 75
    state: replaced

# After state:
# ------------
#
# sonic# show qos wred-policy
# ---------------------------------------------------
# Policy                 : profile1
# ---------------------------------------------------
# green-drop-probability : 75

# Using Overridden
#
# Before state:
# -------------
#
# sonic# show qos wred-policy
# ---------------------------------------------------
# Policy                 : profile1
# ---------------------------------------------------
# ecn                    : ecn_green
# green-min-threshold    : 1           KBytes
# green-max-threshold    : 5           KBytes
# green-drop-probability : 25

- name: Override QoS WRED policy configuration
  dellemc.enterprise_sonic.sonic_qos_wred:
    config:
      - name: profile2
        ecn: green
        green:
          enable: False
          min_threshold: 3000
          max_threshold: 9000
          drop_probability: 75
    state: overridden

# After state:
# ------------
#
# sonic# show qos wred-policy
# ---------------------------------------------------
# Policy                 : profile2
# ---------------------------------------------------
# ecn                    : ecn_green
# green-min-threshold    : 3           KBytes
# green-max-threshold    : 9           KBytes
# green-drop-probability : 75
#
#
# Using deleted
#
# Before state:
# -------------
#
# sonic# show qos wred-policy
# ---------------------------------------------------
# Policy                 : profile1
# ---------------------------------------------------
# ecn                    : ecn_green
# green-min-threshold    : 1           KBytes
# green-max-threshold    : 5           KBytes
# green-drop-probability : 25
# ---------------------------------------------------
# Policy                 : profile2
# ---------------------------------------------------
# ecn                    : ecn_green
# green-min-threshold    : 3           KBytes
# green-max-threshold    : 9           KBytes
# green-drop-probability : 75

- name: Delete QoS WRED policy configuration
  dellemc.enterprise_sonic.sonic_qos_wred:
    config:
      - name: profile1
      - name: profile2
        green:
          enable: False
          min_threshold: 3000
          max_threshold: 9000
    state: deleted

# After state:
# ------------
#
# sonic# show qos wred-policy
# ---------------------------------------------------
# Policy                 : profile2
# ---------------------------------------------------
# ecn                    : ecn_green
# green-drop-probability : 75

返回值 

常见返回值记录在此处，以下是此模块独有的字段

键	描述
after 列表 / 元素=字符串	生成的配置模块调用。返回：当更改时示例： `["返回的配置将始终采用与上述参数相同的格式。\n"]`
after(generated) 列表 / 元素=字符串	生成的配置模块调用。返回：当 `check_mode` 时示例： `["返回的配置将始终采用与上述参数相同的格式。\n"]`
before 列表 / 元素=字符串	模块调用之前的配置。返回：始终示例： `["返回的配置将始终采用与上述参数相同的格式。\n"]`
commands 列表 / 元素=字符串	推送到远程设备的命令集。返回：始终示例： `["命令 1", "命令 2", "命令 3"]`

作者

Shade Talabi (@stalabi1)