Resource Type: cisco_interface

Defined in:

lib/puppet/type/cisco_interface.rb

Providers:

cisco_ios

Overview

This represents a router or switch interface.

Properties

• access (defaults to: absent)

  Set VLAN when interface is in access mode

  Supported values:

  • absent
  • dynamic
  • /^\d+$/
• description

  The description of the interface.

  Supported values:

  • /\A[^\n]*\z/m
• dhcp_snooping_limit_rate (defaults to: absent)

  DHCP snooping rate limit

  Supported values:

  • absent
  • /^\d+$/
• dhcp_snooping_trust (defaults to: absent)

  DHCP Snooping trust config

  Supported values:

  • absent
  • present
• mode (defaults to: absent)

  Set trunking mode of the interface.

  Supported values:

  • absent
  • access
  • dot1q
  • dynamic
  • private
  • trunk
• negotiate (defaults to: true)

  Whether or not this interface will engage in any negotiations

  Supported values:

  • true
  • false
• port_security (defaults to: absent)

  How this interface should react to port security violations.

  Supported values:

  • absent
  • protect
  • restrict
  • shutdown
  • shutdown_vlan
• port_security_aging_time

  How long a port should stay locked after a violation.

  Supported values:

  • absent
  • /^\d+$/
• port_security_aging_type

  Which type of aging should be applied after a violation.

  Supported values:

  • absent
  • absolute
  • inactivity
• port_security_mac_address

  The allowed MAC address on this interface

  Supported values:

  • absent
  • sticky
  • /^([0-9a-fA-F]{2}\:){5}[0-9a-fA-F]{2}$/
• spanning_tree (defaults to: node)

  Configures how this interface takes part in the spanning tree.

  Setting this to ‘leaf` will allow the device on this port to connect immediately, but not participate in STP negotiations. On IOS, this sets bpduguard, and portfast.

  Setting this to ‘node` allows the device to participate in STP negotiations, but incurs a slight delay when connecting. On IOS, this disables bpduguard, and portfast.

  The interface may be in the ‘partial` state, if the options are not configured consistently.

  Supported values:

  • leaf
  • node
  • partial
• spanning_tree_bpduguard

  Don’t accept BPDUs on this interface

  Supported values:

  • present
  • absent
• spanning_tree_cost (defaults to: absent)

  The STP port priority

  Supported values:

  • absent
  • /^\d*$/
• spanning_tree_guard (defaults to: absent)

  The guard mode of this interface.

  Supported values:

  • loop
  • absent
  • root
• spanning_tree_port_priority (defaults to: absent)

  The STP port priority

  Supported values:

  • absent
• trunk_allowed_vlan (defaults to: absent)

  List of allowed VLANs on this interface

  Supported values:

  • absent
  • /^(\d+(-\d+)?,)*\d+(-\d+)?$/
• trunk_encapsulation (defaults to: absent)

  Set trunking encapsulation when interface is in trunking mode

  Supported values:

  • absent
  • dot1q
  • isl
  • negotiate
• trunk_native_vlan (defaults to: absent)

  Set native VLAN when interface is in trunking mode

  Supported values:

  • absent
  • /^\d+$/

Parameters

• name (namevar)

  The interface’s name.

  Supported values:

  • /^\w+[Ee]thernet\S+$/
  • /[Vv]lan\d+$/
  • /[Tt]unnel\d+$/
• provider

  The specific backend to use for this ‘cisco_interface` resource. You will seldom need to specify this — Puppet will usually discover the appropriate provider for your platform.