dellemc.enterprise_sonic.sonic_qos_maps 模块 – 在 SONiC 上管理 QoS 映射配置

注意

此模块是 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_maps。

dellemc.enterprise_sonic 2.5.0 中的新功能

概要

  • 此模块为运行 SONiC 的设备提供 QoS 映射的配置管理

参数

参数

注释

config

字典

QoS 映射配置

dot1p_maps

列表 / 元素=字典

DOT1P 映射配置

entries

列表 / 元素=字典

DOT1P 映射条目配置

dot1p

整数 / 必需

DOT1P 值，范围 0-7

fwd_group

字符串

转发组值，范围 0-7

name

字符串 / 必需

DOT1P 映射的名称

dscp_maps

列表 / 元素=字典

DSCP 映射配置

entries

列表 / 元素=字典

DSCP 映射条目配置

dscp

整数 / 必需

DSCP 值，范围 0-63

fwd_group

字符串

转发组值，范围 0-7

name

字符串 / 必需

DSCP 映射的名称

fwd_group_dot1p_maps

列表 / 元素=字典

转发组 DOT1P 映射配置

entries

列表 / 元素=字典

转发组 DOT1P 映射条目配置

dot1p

整数

DOT1P 值，范围 0-7

fwd_group

字符串 / 必需

转发组值，范围 0-7

name

字符串 / 必需

转发组 DOT1P 映射的名称

fwd_group_dscp_maps

列表 / 元素=字典

转发组 DSCP 映射配置

entries

列表 / 元素=字典

转发组 DSCP 映射条目配置

dscp

整数

DSCP 值，范围 0-63

fwd_group

字符串 / 必需

转发组值，范围 0-7

name

字符串 / 必需

转发组 DSCP 映射的名称

fwd_group_pg_maps

列表 / 元素=字典

转发组优先级组映射配置

entries

列表 / 元素=字典

转发组优先级组条目配置

fwd_group

字符串 / 必需

转发组值，范围 0-7

pg_index

整数

优先级组索引值，范围 0-7

name

字符串 / 必需

转发组优先级组映射的名称

fwd_group_queue_maps

列表 / 元素=字典

转发组队列映射配置

entries

列表 / 元素=字典

转发组队列映射条目配置

fwd_group

字符串 / 必需

转发组值，范围 0-7

queue_index

整数

输出队列索引值，范围 0-7

name

字符串 / 必需

转发组队列映射的名称

pfc_priority_pg_maps

列表 / 元素=字典

PFC 优先级优先级组映射配置

entries

列表 / 元素=字典

PFC 优先级优先级组映射条目配置

dot1p

整数 / 必需

DOT1P 值，范围 0-7

pg_index

整数

优先级组索引值，范围 0-7

name

字符串 / 必需

PFC 优先级优先级组映射的名称

SONiC 目前仅支持配置单个 PFC 优先级优先级组映射

pfc_priority_queue_maps

列表 / 元素=字典

PFC 优先级队列映射配置

entries

列表 / 元素=字典

PFC 优先级队列映射条目配置

dot1p

整数 / 必需

DOT1P 值，范围 0-7

queue_index

整数

输出队列索引值，范围 0-7

name

字符串 / 必需

PFC 优先级队列映射的名称

SONiC 目前仅支持配置单个 PFC 优先级队列映射

state

字符串

模块完成后配置的状态。

选择

  • "merged" ← (默认)

  • "deleted"

  • "overridden"

  • "replaced"

注释

注意

  • 已针对戴尔科技的 Enterprise SONiC 发行版进行测试。

  • 支持 check_mode。

示例

# Using Merged
#
# Before state:
# -------------
#
# sonic# show qos map dscp-tc
# (No qos map dscp-tc configuration present)

- name: Merge QoS maps configurations
  dellemc.enterprise_sonic.sonic_qos_maps:
    config:
      dscp_maps:
        - name: dscp_map1
          entries:
            - dscp: 0
              fwd_group: 0
            - dscp: 1
              fwd_group: 7
        - name: dscp_map2
          entries:
            - dscp: 2
              fwd_group: 4
    state: merged

# After state:
# ------------
#
# sonic# show qos map dscp-tc
# DSCP-TC-MAP: dscp_map1
# ----------------------------
#     DSCP TC
# ----------------------------
#     0    0
#     1    7
# ----------------------------
# DSCP-TC-MAP: dscp_map2
# ----------------------------
#     DSCP TC
# ----------------------------
#     2    4
# ----------------------------
#
#
# Using Replaced
#
# Before state:
# -------------
#
# sonic# show qos map dscp-tc
# DSCP-TC-MAP: dscp_map1
# ----------------------------
#     DSCP TC
# ----------------------------
#     0    0
#     1    7
# ----------------------------
# DSCP-TC-MAP: dscp_map2
# ----------------------------
#     DSCP TC
# ----------------------------
#     2    4
# ----------------------------

- name: Replace QoS maps configurations
  dellemc.enterprise_sonic.sonic_qos_maps:
    config:
      dscp_maps:
        - name: dscp_map1
          entries:
            - dscp: 3
              fwd_group: 5
    state: replaced

# After state:
# ------------
#
# sonic# show qos map dscp-tc
# DSCP-TC-MAP: dscp_map1
# ----------------------------
#     DSCP TC
# ----------------------------
#     3    5
# ----------------------------
# DSCP-TC-MAP: dscp_map2
# ----------------------------
#     DSCP TC
# ----------------------------
#     2    4
# ----------------------------
#
#
# Using Overridden
# Before state:
# -------------
#
# sonic# show qos map dscp-tc
# DSCP-TC-MAP: dscp_map1
# ----------------------------
#     DSCP TC
# ----------------------------
#     3    5
# ----------------------------
# DSCP-TC-MAP: dscp_map2
# ----------------------------
#     DSCP TC
# ----------------------------
#     2    4
# ----------------------------

- name: Override QoS maps configurations
  dellemc.enterprise_sonic.sonic_qos_maps:
    config:
      pfc_priority_queue_maps:
        - name: pfc_map1
          entries:
            - dot1p: 0
              queue_index: 0
            - dot1p: 4
              queue_index: 5
    state: overridden

# After state:
# ------------
#
# sonic# show qos map pfc-priority-queue
# PFC-Priority-Queue-MAP: pfc_map1
# ----------------------------
#     PFC Priority   Queue
# ----------------------------
#     0              0
#     4              5
# ----------------------------
#
#
# Using deleted
#
# Before state:
# -------------
#
# sonic# show qos map dot1p-tc
# DOT1P-TC-MAP: dot1p_map1
# ----------------------------
#     DOT1P  TC
# ----------------------------
#     0      0
#     1      6
# ----------------------------
# DOT1P-TC-MAP: dot1p_map2
# ----------------------------
#     DOT1P  TC
# ----------------------------
#     2      5
# ----------------------------

- name: Delete QoS maps configurations
  dellemc.enterprise_sonic.sonic_qos_maps:
    config:
      dot1p_maps:
        - name: dot1p_map1
          entries:
            - dot1p: 0
            - dot1p: 1
              fwd_group: 6
        - name: dot1p_map2
    state: deleted

# After state:
# ------------
#
# sonic# show qos map dot1p-tc
# (No qos map dot1p-tc configuration present)

返回值

通用返回值记录在此处，以下是此模块特有的字段

键

描述

after

列表 / 元素=字符串

生成的配置模块调用。

已返回: 当发生更改时

示例: ["返回的配置将始终与上面的参数格式相同。\n"]

after(generated)

列表 / 元素=字符串

生成的配置模块调用。

已返回: 当 check_mode 时

示例: ["返回的配置将始终与上面的参数格式相同。\n"]

before

列表 / 元素=字符串

模块调用之前的配置。

已返回: 始终

示例: ["返回的配置将始终与上面的参数格式相同。\n"]

commands

列表 / 元素=字符串

推送到远程设备的命令集。

已返回: 始终

示例: ["命令 1", "命令 2", "命令 3"]

作者

  • Shade Talabi (@stalabi1)