community.network.flowadm module – Manage bandwidth resource control and priority for protocols, services and zones on Solaris/illumos systems
Note
This module is part of the community.network collection (version 5.0.3).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.network
.
To use it in a playbook, specify: community.network.flowadm
.
Synopsis
Create/modify/remove networking bandwidth and associated resources for a type of traffic on a particular link.
Aliases: network.illumos.flowadm
Parameters
Parameter |
Comments |
---|---|
|
|
Specifiies a link to configure flow on. |
|
Identifies a network flow by the local IP address. |
|
Identifies a service specified by the local port. |
|
|
|
|
|
Sets the relative priority for the flow. Choices:
|
|
Identifies a network flow by the remote IP address. |
|
Create/delete/enable/disable an IP address on the network interface. Choices:
|
|
Specifies that the configured flow is temporary. Temporary flows do not persist across reboots. Choices:
|
|
|
Examples
- 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
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
flow’s differentiated services value Returned: if dsfield is defined Sample: |
|
flow’s link Returned: if link is defined Sample: |
|
flow’s local IP address Returned: if local_ip is defined Sample: |
|
flow’s local port Returned: if local_port is defined Sample: |
|
flow’s maximum bandwidth Returned: if maxbw is defined Sample: |
|
flow name Returned: always Sample: |
|
flow’s priority Returned: if priority is defined Sample: |
|
flow’s remote IP address Returned: if remote_ip is defined Sample: |
|
state of the target Returned: always Sample: |
|
flow’s persistence Returned: always Sample: |
|
flow’s transport Returned: if transport is defined Sample: |