community.network.flowadm 模块 – 在 Solaris/illumos 系统上管理协议、服务和区域的带宽资源控制和优先级

注意

此模块是 community.network 集合（版本 5.1.0）的一部分。

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

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

要在 playbook 中使用它，请指定：community.network.flowadm。

注意

community.network 集合已被弃用，并将从 Ansible 12 中删除。有关更多信息，请参阅讨论主题。

已弃用

在以下版本中删除:

版本 6.0.0

原因:

此集合及其中的所有内容均未维护且已弃用。

替代方案:

未知。

概要

• 为特定链接上的某种类型的流量创建/修改/删除网络带宽和相关资源。

别名：network.illumos.flowadm

参数

参数	注释
dsfield 字符串	标识 8 位差分服务字段（如 RFC 2474 中定义）。当与 dsfield 值进行比较时，可选的 dsfield_mask 用于声明差分服务字段中感兴趣的位。两个值都必须是十六进制。
link 字符串	指定要配置流量的链接。
local_ip 字符串	通过本地 IP 地址标识网络流量。
local_port 字符串	标识由本地端口指定的服务。
maxbw 字符串	设置流量的全双工带宽。带宽指定为带有比例后缀（K、M 或 G 分别表示 Kbps、Mbps 和 Gbps）的整数。如果未指定单位，则将输入值读取为 Mbps。
name 别名：flow 字符串 / 必需	流量定义为一组基于第 3 层和第 4 层标头的属性，可用于标识协议、服务或区域。
priority 字符串	设置流量的相对优先级。 选项 "low" "medium" ←（默认） "high"
remote_ip 字符串	通过远程 IP 地址标识网络流量。
state 字符串	在网络接口上创建/删除/启用/禁用 IP 地址。 选项 "absent" "present" ←（默认） "resetted"
temporary 布尔值	指定配置的流量是临时的。临时流量不会在重新启动时保留。 选项 false ←（默认） true
transport 字符串	指定要使用的第 4 层协议。它通常与 local_port 结合使用，以识别需要特别注意的服务。

示例

- name: Limit SSH traffic to 100M via vnic0 interface
  community.network.flowadm:
    link: vnic0
    flow: ssh_out
    transport: tcp
    local_port: 22
    maxbw: 100M
    state: present

- name: Reset flow properties
  community.network.flowadm:
    name: dns
    state: resetted

- name: Configure policy for EF PHB (DSCP value of 101110 from RFC 2598) with a bandwidth of 500 Mbps and a high priority
  community.network.flowadm:
    link: bge0
    dsfield: '0x2e:0xfc'
    maxbw: 500M
    priority: high
    flow: efphb-flow
    state: present

返回值

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

键	描述
dsfield 字符串	流量的差分服务值 返回：如果定义了 dsfield 示例： "0x2e:0xfc"
link 字符串	流量的链接 返回：如果定义了链接 示例： "vnic0"
local_Ip 字符串	流量的本地 IP 地址 返回：如果定义了 local_ip 示例： "10.0.0.42"
local_port 整数	流量的本地端口 返回：如果定义了 local_port 示例： 1337
maxbw 字符串	流量的最大带宽 返回：如果定义了 maxbw 示例： "100M"
name 字符串	流量名称 返回：始终 示例: "http_drop"
priority 字符串	流的优先级 返回: 如果定义了优先级 示例: "low"
远程IP 字符串	流的远程 IP 地址 返回: 如果定义了 remote_ip 示例： "10.0.0.42"
state 字符串	目标的状态 返回：始终 示例: "present"
temporary 布尔值	流的持久性 返回：始终 示例: true
transport 字符串	流的传输协议 返回: 如果定义了传输协议 示例: "tcp"

状态

• 此模块将在 6.0.0 版本中移除。 [已弃用]

• 更多信息请参考 已弃用。

作者

• Adam Števko (@xen0l)

集合链接

• 问题跟踪器
• 存储库 (源代码)