community.general.pn_trunk (0.1.1) — module

Install collection

Install with ansible-galaxy collection install community.general:==0.1.1

Add to requirements.yml

  collections:
    - name: community.general
      version: 0.1.1

Description

Execute trunk-create or trunk-delete command.

Trunks can be used to aggregate network links at Layer 2 on the local switch. Use this command to create a new trunk.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: create trunk
  pn_trunk:
    state: 'present'
    pn_name: 'spine-to-leaf'
    pn_ports: '11,12,13,14'

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: delete trunk
  pn_trunk:
    state: 'absent'
    pn_name: 'spine-to-leaf'

Inputs

    
state:
    choices:
    - present
    - absent
    - update
    description:
    - State the action to perform. Use 'present' to create trunk, 'absent' to delete trunk
      and 'update' to modify trunk.
    required: true

pn_host:
    description:
    - Host facing port control setting.
    type: bool

pn_name:
    description:
    - Specify the name for the trunk configuration.
    required: true

pn_jumbo:
    description:
    - Specify if the port can receive jumbo frames.
    type: bool

pn_pause:
    description:
    - Specify if pause frames are sent.
    type: bool

pn_ports:
    description:
    - Specify the port number(s) for the link(s) to aggregate into the trunk.
    - Required for trunk-create.

pn_speed:
    choices:
    - disable
    - 10m
    - 100m
    - 1g
    - 2.5g
    - 10g
    - 40g
    description:
    - Specify the port speed or disable the port.

pn_routing:
    description:
    - Specify if the port participates in routing on the network.
    type: bool

pn_loopback:
    description:
    - Specify loopback if you want to use loopback.
    type: bool

pn_cliswitch:
    default: local
    description:
    - Target switch(es) to run the cli on.
    required: false

pn_lacp_mode:
    choices:
    - 'off'
    - passive
    - active
    description:
    - Specify the LACP mode for the configuration.

pn_loopvlans:
    description:
    - Specify a list of looping vlans.

pn_clipassword:
    description:
    - Provide login password if user is not root.
    required: false

pn_cliusername:
    description:
    - Provide login username if user is not root.
    required: false

pn_description:
    description:
    - Specify a description for the trunk configuration.

pn_edge_switch:
    description:
    - Specify if the switch is an edge switch.
    type: bool

pn_lacp_timeout:
    choices:
    - slow
    - fast
    description:
    - Specify the LACP time out as slow (30 seconds) or fast (4seconds). The default value
      is slow.

pn_port_macaddr:
    description:
    - Specify the MAC address of the port.

pn_lacp_fallback:
    choices:
    - bundle
    - individual
    description:
    - Specify the LACP fallback mode as bundles or individual.

pn_lacp_priority:
    description:
    - Specify the LACP priority. This is a number between 1 and 65535 with a default value
      of 32768.

pn_mirror_receive:
    description:
    - Specify if the configuration receives mirrored traffic.
    type: bool

pn_broadcast_level:
    description:
    - Specify a broadcast level in percent. The default value is 100%.

pn_egress_rate_limit:
    description:
    - Specify an egress port data rate limit for the configuration.

pn_unknown_mcast_level:
    description:
    - Specify an unknown multicast level in percent. The default value is 100%.

pn_unknown_ucast_level:
    description:
    - Specify an unknown unicast level in percent. The default value is 100%.

pn_lacp_fallback_timeout:
    description:
    - Specify the LACP fallback timeout in seconds. The range is between 30 and 60 seconds
      with a default value of 50 seconds.

Outputs

changed:
  description: Indicates whether the CLI caused changes on the target.
  returned: always
  type: bool
command:
  description: The CLI command run on the target node(s).
  returned: always
  type: str
stderr:
  description: The set of error responses from the trunk command.
  returned: on error
  type: list
stdout:
  description: The set of responses from the trunk command.
  returned: always
  type: list