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

注意

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

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

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

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

注意

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

已弃用

在以下版本中移除：

6.0.0 版本

原因：

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

替代方案：

未知。

概要

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

别名：network.illumos.flowadm

参数

参数	注释
dsfield 字符串	标识 8 位差异化服务字段（如 RFC 2474 中所定义）。可选的 dsfield_mask 用于在与 dsfield 值比较时声明差异化服务字段中感兴趣的位。两个值都必须为十六进制。
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 字符串	流量的链路 返回：如果定义了 link 示例： "vnic0"
local_Ip 字符串	流量的本地 IP 地址 返回：如果定义了 local_ip 示例： "10.0.0.42"
local_port 整数	流的本地端口 返回：如果定义了local_port 示例： 1337
maxbw 字符串	流的最大带宽 返回：如果定义了maxbw 示例： "100M"
名称 字符串	流名称 返回：始终返回 示例： "http_drop"
priority 字符串	流的优先级 返回：如果定义了priority 示例： "low"
远程IP 字符串	流的远程IP地址 返回：如果定义了remote_ip 示例： "10.0.0.42"
state 字符串	目标状态 返回：始终返回 示例： "present"
temporary 布尔值	流的持久性 返回：始终返回 示例： true
transport 字符串	流的传输协议 返回：如果定义了transport 示例： "tcp"

状态

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

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

作者

• Adam Števko (@xen0l)

资源链接

• 问题跟踪
• 代码仓库