community.network.pn_port_config – CLI command to modify port-config

Note

This plugin is part of the community.network collection (version 3.0.0).

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.pn_port_config.

Synopsis

  • This module can be used to modify a port configuration.

Parameters

Parameter Choices/Defaults Comments
pn_allowed_tpid
string
    Choices:
  • vlan
  • q-in-q
  • q-in-q-old
Allowed TPID in addition to 0x8100 on Vlan header.
pn_autoneg
boolean
    Choices:
  • no
  • yes
physical port autonegotiation.
pn_cliswitch
string
Target switch to run the CLI on.
pn_crc_check_enable
boolean
    Choices:
  • no
  • yes
CRC check on ingress and rewrite on egress.
pn_defer_bringup
boolean
    Choices:
  • no
  • yes
defer port bringup.
pn_description
string
physical port description.
pn_dscp_map
string
DSCP map name to enable on port.
pn_edge_switch
boolean
    Choices:
  • no
  • yes
physical port edge switch.
pn_egress_rate_limit
string
max egress port data rate limit.
pn_enable
boolean
    Choices:
  • no
  • yes
physical port enable.
pn_eth_mode
string
    Choices:
  • 1000base-x
  • sgmii
  • disabled
  • GMII
physical Ethernet mode.
pn_fabric_guard
boolean
    Choices:
  • no
  • yes
Fabric guard configuration.
pn_host_enable
boolean
    Choices:
  • no
  • yes
Host facing port control setting.
pn_intf
string
physical interface.
pn_jumbo
boolean
    Choices:
  • no
  • yes
jumbo frames on physical port.
pn_lacp_priority
string
LACP priority from 1 to 65535.
pn_local_switching
boolean
    Choices:
  • no
  • yes
no-local-switching port cannot bridge traffic to another no-local-switching port.
pn_loop_vlans
string
looping vlans.
pn_loopback
boolean
    Choices:
  • no
  • yes
physical port loopback.
pn_mirror_only
boolean
    Choices:
  • no
  • yes
physical port mirror only.
pn_pause
boolean
    Choices:
  • no
  • yes
physical port pause.
pn_port
string
physical port.
pn_port_mac_address
string
physical port MAC Address.
pn_reflect
boolean
    Choices:
  • no
  • yes
physical port reflection.
pn_routing
boolean
    Choices:
  • no
  • yes
routing.
pn_send_port
string
send port.
pn_speed
string
    Choices:
  • disable
  • 10m
  • 100m
  • 1g
  • 2.5g
  • 10g
  • 25g
  • 40g
  • 50g
  • 100g
physical port speed.
pn_vxlan_termination
boolean
    Choices:
  • no
  • yes
physical port vxlan termination setting.
state
string / required
    Choices:
  • update
State the action to perform. Use update to modify the port-config.

Examples

- name: Port config modify
  community.network.pn_port_config:
    pn_cliswitch: "sw01"
    state: "update"
    pn_port: "all"
    pn_dscp_map: "foo"

- name: Port config modify
  community.network.pn_port_config:
    pn_cliswitch: "sw01"
    state: "update"
    pn_port: "all"
    pn_host_enable: true

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
changed
boolean
always
indicates whether the CLI caused changes on the target.
command
string
always
the CLI command run on the target node.
stderr
list / elements=string
on error
set of error responses from the port-config command.
stdout
list / elements=string
always
set of responses from the port-config command.


Authors

  • Pluribus Networks (@rajaspachipulusu17)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/network/pn_port_config_module.html