cisco.ios.ios_evpn_evi (8.0.0) — module

Install collection

Install with ansible-galaxy collection install cisco.ios:==8.0.0

Add to requirements.yml

  collections:
    - name: cisco.ios
      version: 8.0.0

Description

This module provides declarative management of L2VPN EVPN EVI on Cisco IOS network devices.

Inputs

    
state:
    choices:
    - merged
    - replaced
    - overridden
    - deleted
    - gathered
    - rendered
    - parsed
    default: merged
    description:
    - The state the configuration should be left in
    type: str

config:
    description: A dictionary of L2VPN Ethernet Virtual Private Network (EVPN) EVI configuration
    elements: dict
    suboptions:
      default_gateway:
        description: Default Gateway parameters
        suboptions:
          advertise:
            description: Advertise Default Gateway MAC/IP routes
            suboptions:
              disable:
                description: Disable advertisement of Default Gateway MAC/IP routes
                type: bool
              enable:
                description: Enable advertisement of Default Gateway MAC/IP routes
                type: bool
            type: dict
        type: dict
      encapsulation:
        choices:
        - vxlan
        default: vxlan
        description: EVPN encapsulation type
        type: str
      evi:
        description: EVPN instance value
        required: true
        type: int
      ip:
        description: IP parameters
        suboptions:
          local_learning:
            description: IP local learning
            suboptions:
              disable:
                description: Disable IP local learning
                type: bool
              enable:
                description: Enable IP local learning
                type: bool
            type: dict
        type: dict
      replication_type:
        choices:
        - ingress
        - static
        description: Method for replicating BUM traffic
        type: str
      route_distinguisher:
        description: EVPN Route Distinguisher
        type: str
    type: list

running_config:
    description:
    - This option is used only with state I(parsed).
    - The value of this option should be the output received from the IOS device by executing
      the command B(sh running-config nve | section ^l2vpn evpn$).
    - The state I(parsed) reads the configuration from C(running_config) option and transforms
      it into Ansible structured data as per the resource module's argspec and the value
      is then returned in the I(parsed) key within the result.
    type: str

Outputs

after:
  description: The resulting configuration after module execution.
  returned: when changed
  sample: 'This output will always be in the same format as the module argspec.

    '
  type: dict
before:
  description: The configuration prior to the module execution.
  returned: when I(state) is C(merged), C(replaced), C(overridden), C(deleted) or
    C(purged)
  sample: 'This output will always be in the same format as the module argspec.

    '
  type: dict
commands:
  description: The set of commands pushed to the remote device.
  returned: when I(state) is C(merged), C(replaced), C(overridden), C(deleted) or
    C(purged)
  sample:
  - l2vpn evpn instance 101 vlan-based
  - encapsulation vxlan
  - replication-type ingress
  type: list