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。

要在剧本中使用它，请指定： 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"`

备注 

注意

针对戴尔科技公司的企业 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 列表 / 元素=字符串	生成的模块调用后的配置。返回值：发生更改时示例： `["The configuration returned will always be in the same format as the parameters above.\n"]`
after(generated) 列表 / 元素=字符串	生成的模块调用后的配置。返回值：当 `check_mode` 时示例： `["返回的配置将始终与上述参数格式相同\n"]`
之前列表 / 元素=字符串	模块调用之前的配置。返回：始终示例： `["The configuration returned will always be in the same format as the parameters above.\n"]`
命令列表 / 元素=字符串	推送到远程设备的命令集。返回：始终示例： `["命令 1", "命令 2", "命令 3"]`

作者

Shade Talabi (@stalabi1)