.. Document meta

:orphan:

.. |antsibull-internal-nbsp| unicode:: 0xA0
    :trim:

.. meta::
  :antsibull-docs: 2.23.0

.. Anchors

.. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module:

.. Anchors: short name for ansible.builtin

.. Title

amnesh.soodar.soodar_l3_interfaces module -- Resource module to configure L3 interfaces.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

.. Collection note

.. note::
    This module is part of the `amnesh.soodar collection <https://soodar.ir>`_ (version 2.0.0).

    It is not included in ``ansible-core``.
    To check whether it is installed, run :code:`ansible-galaxy collection list`.

    To install it, use: :code:`ansible\-galaxy collection install https://soodar.ir/ansible/amnesh.soodar.tar.gz`.

    To use it in a playbook, specify: :code:`amnesh.soodar.soodar_l3_interfaces`.

.. version_added


.. contents::
   :local:
   :depth: 1

.. Deprecated


Synopsis
--------

.. Description

- This module provides declarative management of Layer\-3 interface on Amnesh Soodar devices.

.. note::
    This module has a corresponding :ref:`action plugin <action_plugins>`.

.. Aliases


.. Requirements






.. Options

Parameters
----------

.. tabularcolumns:: \X{1}{3}\X{2}{3}

.. list-table::
  :width: 100%
  :widths: auto
  :header-rows: 1
  :class: longtable ansible-option-table

  * - Parameter
    - Comments

  * - .. raw:: html

        <div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-config"></div>

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-config:

      .. rst-class:: ansible-option-title

      **config**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-config" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary`

      .. raw:: html

        </div>

    - .. raw:: html

        <div class="ansible-option-cell">

      A dictionary of Layer\-3 interface options


      .. raw:: html

        </div>

  * - .. raw:: html

        <div class="ansible-option-indent"></div><div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-config/ipv4"></div>

      .. raw:: latex

        \hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-config/ipv4:

      .. rst-class:: ansible-option-title

      **ipv4**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-config/ipv4" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary`

      .. raw:: html

        </div>

      .. raw:: latex

        \end{minipage}

    - .. raw:: html

        <div class="ansible-option-indent-desc"></div><div class="ansible-option-cell">

      IPv4 address to be set for the Layer\-3 interface mentioned in :emphasis:`name` option. The address format is \<ipv4 address\>/\<mask\>, the mask is number in range 0\-32 eg. 192.168.0.1/24


      .. raw:: html

        </div>

  * - .. raw:: html

        <div class="ansible-option-indent"></div><div class="ansible-option-indent"></div><div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-config/ipv4/address"></div>

      .. raw:: latex

        \hspace{0.04\textwidth}\begin{minipage}[t]{0.28\textwidth}

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-config/ipv4/address:

      .. rst-class:: ansible-option-title

      **address**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-config/ipv4/address" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`string`

      .. raw:: html

        </div>

      .. raw:: latex

        \end{minipage}

    - .. raw:: html

        <div class="ansible-option-indent-desc"></div><div class="ansible-option-indent-desc"></div><div class="ansible-option-cell">

      Configures the IPv4 address for Interface.


      .. raw:: html

        </div>

  * - .. raw:: html

        <div class="ansible-option-indent"></div><div class="ansible-option-indent"></div><div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-config/ipv4/dhcp"></div>

      .. raw:: latex

        \hspace{0.04\textwidth}\begin{minipage}[t]{0.28\textwidth}

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-config/ipv4/dhcp:

      .. rst-class:: ansible-option-title

      **dhcp**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-config/ipv4/dhcp" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`dictionary`

      .. raw:: html

        </div>

      .. raw:: latex

        \end{minipage}

    - .. raw:: html

        <div class="ansible-option-indent-desc"></div><div class="ansible-option-indent-desc"></div><div class="ansible-option-cell">

      IP Address negotiated via DHCP.


      .. raw:: html

        </div>

  * - .. raw:: html

        <div class="ansible-option-indent"></div><div class="ansible-option-indent"></div><div class="ansible-option-indent"></div><div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-config/ipv4/dhcp/enable"></div>

      .. raw:: latex

        \hspace{0.06\textwidth}\begin{minipage}[t]{0.26\textwidth}

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-config/ipv4/dhcp/enable:

      .. rst-class:: ansible-option-title

      **enable**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-config/ipv4/dhcp/enable" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`boolean`

      .. raw:: html

        </div>

      .. raw:: latex

        \end{minipage}

    - .. raw:: html

        <div class="ansible-option-indent-desc"></div><div class="ansible-option-indent-desc"></div><div class="ansible-option-indent-desc"></div><div class="ansible-option-cell">

      Enable dhcp.


      .. rst-class:: ansible-option-line

      :ansible-option-choices:`Choices:`

      - :ansible-option-choices-entry:`false`
      - :ansible-option-choices-entry:`true`


      .. raw:: html

        </div>


  * - .. raw:: html

        <div class="ansible-option-indent"></div><div class="ansible-option-indent"></div><div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-config/ipv4/mtu"></div>

      .. raw:: latex

        \hspace{0.04\textwidth}\begin{minipage}[t]{0.28\textwidth}

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-config/ipv4/mtu:

      .. rst-class:: ansible-option-title

      **mtu**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-config/ipv4/mtu" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`integer`

      .. raw:: html

        </div>

      .. raw:: latex

        \end{minipage}

    - .. raw:: html

        <div class="ansible-option-indent-desc"></div><div class="ansible-option-indent-desc"></div><div class="ansible-option-cell">

      Set IP Maximum Transmission Unit.


      .. raw:: html

        </div>

  * - .. raw:: html

        <div class="ansible-option-indent"></div><div class="ansible-option-indent"></div><div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-config/ipv4/proxy_arp"></div>

      .. raw:: latex

        \hspace{0.04\textwidth}\begin{minipage}[t]{0.28\textwidth}

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-config/ipv4/proxy_arp:

      .. rst-class:: ansible-option-title

      **proxy_arp**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-config/ipv4/proxy_arp" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`boolean`

      .. raw:: html

        </div>

      .. raw:: latex

        \end{minipage}

    - .. raw:: html

        <div class="ansible-option-indent-desc"></div><div class="ansible-option-indent-desc"></div><div class="ansible-option-cell">

      Enable proxy\_arp.


      .. rst-class:: ansible-option-line

      :ansible-option-choices:`Choices:`

      - :ansible-option-choices-entry:`false`
      - :ansible-option-choices-entry:`true`


      .. raw:: html

        </div>


  * - .. raw:: html

        <div class="ansible-option-indent"></div><div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-config/ipv6"></div>

      .. raw:: latex

        \hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-config/ipv6:

      .. rst-class:: ansible-option-title

      **ipv6**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-config/ipv6" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary`

      .. raw:: html

        </div>

      .. raw:: latex

        \end{minipage}

    - .. raw:: html

        <div class="ansible-option-indent-desc"></div><div class="ansible-option-cell">

      IPv6 address to be set for the Layer\-3 interface mentioned in :emphasis:`name` option.

      The address format is \<ipv6 address\>/\<mask\>, the mask is number in range 0\-128 eg. fd5d:12c9:2201:1::1/64


      .. raw:: html

        </div>

  * - .. raw:: html

        <div class="ansible-option-indent"></div><div class="ansible-option-indent"></div><div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-config/ipv6/address"></div>

      .. raw:: latex

        \hspace{0.04\textwidth}\begin{minipage}[t]{0.28\textwidth}

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-config/ipv6/address:

      .. rst-class:: ansible-option-title

      **address**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-config/ipv6/address" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`string`

      .. raw:: html

        </div>

      .. raw:: latex

        \end{minipage}

    - .. raw:: html

        <div class="ansible-option-indent-desc"></div><div class="ansible-option-indent-desc"></div><div class="ansible-option-cell">

      Configures the IPv6 address for Interface.


      .. raw:: html

        </div>

  * - .. raw:: html

        <div class="ansible-option-indent"></div><div class="ansible-option-indent"></div><div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-config/ipv6/enable"></div>

      .. raw:: latex

        \hspace{0.04\textwidth}\begin{minipage}[t]{0.28\textwidth}

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-config/ipv6/enable:

      .. rst-class:: ansible-option-title

      **enable**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-config/ipv6/enable" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`boolean`

      .. raw:: html

        </div>

      .. raw:: latex

        \end{minipage}

    - .. raw:: html

        <div class="ansible-option-indent-desc"></div><div class="ansible-option-indent-desc"></div><div class="ansible-option-cell">

      Enable IPv6 on interface


      .. rst-class:: ansible-option-line

      :ansible-option-choices:`Choices:`

      - :ansible-option-choices-entry:`false`
      - :ansible-option-choices-entry:`true`


      .. raw:: html

        </div>

  * - .. raw:: html

        <div class="ansible-option-indent"></div><div class="ansible-option-indent"></div><div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-config/ipv6/eui"></div>

      .. raw:: latex

        \hspace{0.04\textwidth}\begin{minipage}[t]{0.28\textwidth}

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-config/ipv6/eui:

      .. rst-class:: ansible-option-title

      **eui**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-config/ipv6/eui" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`boolean`

      .. raw:: html

        </div>

      .. raw:: latex

        \end{minipage}

    - .. raw:: html

        <div class="ansible-option-indent-desc"></div><div class="ansible-option-indent-desc"></div><div class="ansible-option-cell">

      Use eui\-64 interface identifier


      .. rst-class:: ansible-option-line

      :ansible-option-choices:`Choices:`

      - :ansible-option-choices-entry:`false`
      - :ansible-option-choices-entry:`true`


      .. raw:: html

        </div>


  * - .. raw:: html

        <div class="ansible-option-indent"></div><div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-config/mac_address"></div>

      .. raw:: latex

        \hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-config/mac_address:

      .. rst-class:: ansible-option-title

      **mac_address**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-config/mac_address" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`string`

      .. raw:: html

        </div>

      .. raw:: latex

        \end{minipage}

    - .. raw:: html

        <div class="ansible-option-indent-desc"></div><div class="ansible-option-cell">

      Manually set interface MAC address.


      .. raw:: html

        </div>

  * - .. raw:: html

        <div class="ansible-option-indent"></div><div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-config/name"></div>

      .. raw:: latex

        \hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-config/name:

      .. rst-class:: ansible-option-title

      **name**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-config/name" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`string` / :ansible-option-required:`required`

      .. raw:: html

        </div>

      .. raw:: latex

        \end{minipage}

    - .. raw:: html

        <div class="ansible-option-indent-desc"></div><div class="ansible-option-cell">

      Full name of the interface e.g. ge0.


      .. raw:: html

        </div>


  * - .. raw:: html

        <div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-running_config"></div>

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-running_config:

      .. rst-class:: ansible-option-title

      **running_config**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-running_config" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`string`

      .. raw:: html

        </div>

    - .. raw:: html

        <div class="ansible-option-cell">

      This option is used only with state :emphasis:`parsed`.

      The value of this option should be the output received from the Soodar device by executing the command :strong:`show running\-config \| section ^interface`.

      The state :emphasis:`parsed` reads the configuration from :literal:`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 :emphasis:`parsed` key within the result.


      .. raw:: html

        </div>

  * - .. raw:: html

        <div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="parameter-state"></div>

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__parameter-state:

      .. rst-class:: ansible-option-title

      **state**

      .. raw:: html

        <a class="ansibleOptionLink" href="#parameter-state" title="Permalink to this option"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`string`

      .. raw:: html

        </div>

    - .. raw:: html

        <div class="ansible-option-cell">

      The state the configuration should be left in

      The states :emphasis:`rendered`\ , :emphasis:`gathered` and :emphasis:`parsed` does not perform any change on the device.

      The state :emphasis:`rendered` will transform the configuration in :literal:`config` option to platform specific CLI commands which will be returned in the :emphasis:`rendered` key within the result. For state :emphasis:`rendered` active connection to remote host is not required.

      The state :emphasis:`gathered` will fetch the running configuration from device and transform it into structured data in the format as per the resource module argspec and the value is returned in the :emphasis:`gathered` key within the result.

      The state :emphasis:`parsed` reads the configuration from :literal:`running\_config` option and transforms it into JSON format as per the resource module parameters and the value is returned in the :emphasis:`parsed` key within the result. The value of :literal:`running\_config` option should be the same format as the output of command :emphasis:`show running\-config \| section ^interface` executed on device. For state :emphasis:`parsed` active connection to remote host is not required.


      .. rst-class:: ansible-option-line

      :ansible-option-choices:`Choices:`

      - :ansible-option-choices-entry-default:`"merged"` :ansible-option-choices-default-mark:`← (default)`
      - :ansible-option-choices-entry:`"replaced"`
      - :ansible-option-choices-entry:`"overridden"`
      - :ansible-option-choices-entry:`"deleted"`
      - :ansible-option-choices-entry:`"rendered"`
      - :ansible-option-choices-entry:`"gathered"`
      - :ansible-option-choices-entry:`"parsed"`


      .. raw:: html

        </div>


.. Attributes


.. Notes

Notes
-----

.. note::
   - Tested against Soodar Version 23.11
   - This module works with connection :literal:`amnesh.soodar.network\_cli`.
   - The module examples uses callback plugin (stdout\_callback = yaml) to generate task output in yaml format.

.. Seealso


.. Examples

Examples
--------

.. code-block:: yaml+jinja

    # Using merged

    # Before state:
    # -------------
    #
    # Router# show running-config | section ^interface
    # interface loopback999
    #  no ip address
    #  shutdown
    # interface ge1
    #  description Management interface do not change
    #  ip address dhcp
    # interface ge2
    #  ip address dhcp
    #  shutdown
    #  speed 1000
    # interface ge3
    #  description Configured and Overridden by Ansible Network
    #  no ip address
    #  shutdown
    #  speed 1000
    # interface ge4
    #  no ip address
    #  shutdown


    - name: Merge provided configuration with device configuration
      amnesh.soodar.soodar_l3_interfaces:
        config:
          - name: ge1
            ipv4:
              - address: 192.168.0.1/24
          - name: ge2
            ipv4:
              - address: 192.168.0.2/24
          - name: ge3
            ipv6:
              - address: fd5d:12c9:2201:1::1/64
          - name: ge3.100
            ipv4:
              - address: 192.168.0.3/24
        state: merged

    # Task Output
    # -----------
    #
    # before:
    # - ipv4:
    #   - dhcp:
    #       enable: true
    #   name: ge1
    # - ipv4:
    #   - dhcp:
    #       enable: true
    #   name: ge2
    # - name: ge3
    # - name: ge4
    # - name: loopback999
    # commands:
    # - interface ge2
    # - ip address 192.168.0.2/24
    # - interface ge3
    # - ipv6 address fd5d:12c9:2201:1::1/64
    # - interface ge3.100
    # - ip address 192.168.0.3/24
    # after:
    # - ipv4:
    #   - dhcp:
    #       enable: true
    #   name: ge1
    # - ipv4:
    #   - address: 192.168.0.2/24
    #   name: ge2
    # - ipv6:
    #   - address: FD5D:12C9:2201:1::1/64
    #   name: ge3
    # - name: ge3.100
    #   ipv4:
    #   - address: 192.168.0.3/24
    # - name: ge4
    # - name: loopback999

    # After state:
    # ------------
    #
    # Router# show running-config | section ^interface
    # interface loopback999
    #  no ip address
    #  shutdown
    # interface ge1
    #  description Management interface do not change
    #  ip address dhcp
    # interface ge2
    #  ip address 192.168.0.2/24
    #  shutdown
    #  speed 1000
    # interface ge3
    #  description Configured and Overridden by Ansible Network
    #  no ip address
    #  shutdown
    #  speed 1000
    #  ipv6 address FD5D:12C9:2201:1::1/64
    # interface ge3.100
    #  ip address 192.168.0.3/24
    # interface ge4
    #  no ip address
    #  shutdown

    # Using replaced

    # Before state:
    # -------------
    #
    # Router# show running-config | section ^interface
    # interface loopback999
    #  no ip address
    #  shutdown
    # interface ge1
    #  description Management interface do not change
    #  ip address dhcp
    # interface ge2
    #  ip address 192.168.0.2/24
    #  shutdown
    #  speed 1000
    # interface ge3
    #  description Configured and Overridden by Ansible Network
    #  no ip address
    #  shutdown
    #  speed 1000
    #  ipv6 address FD5D:12C9:2201:1::1/64
    # interface ge3.100
    # interface ge4
    #  no ip address
    #  shutdown

    - name: Replaces device configuration of listed interfaces with provided configuration
      amnesh.soodar.soodar_l3_interfaces:
        config:
          - name: ge2
            ipv4:
              - address: 192.168.2.0/24
          - name: ge3
            ipv4:
              - dhcp:
                  enable: true
        state: replaced

    # Task Output
    # -----------
    #
    # before:
    # - ipv4:
    #   - dhcp:
    #       enable: true
    #   name: ge1
    # - ipv4:
    #   - address: 192.168.0.2/24
    #   name: ge2
    # - ipv6:
    #   - address: FD5D:12C9:2201:1::1/64
    #   name: ge3
    # - name: ge3.100
    # - name: ge4
    # - name: loopback999
    # commands:
    # - interface ge2
    # - ip address 192.168.0.3/24
    # - no ip address 192.168.0.2/24
    # - interface ge3
    # - ip address dhcp
    # - no ipv6 address fd5d:12c9:2201:1::1/64
    # after:
    # - ipv4:
    #   - dhcp:
    #       enable: true
    #   name: ge1
    # - ipv4:
    #   - address: 192.168.0.3/24
    #   name: ge2
    # - ipv4:
    #   - dhcp:
    #       enable: true
    #   name: ge3
    # - name: ge3.100
    # - name: ge4
    # - name: loopback999

    # After state:
    # ------------
    #
    # Router# show running-config | section ^interface
    # interface loopback999
    #  no ip address
    #  shutdown
    # interface ge1
    #  description Management interface do not change
    #  ip address dhcp
    # interface ge2
    #  ip address 192.168.0.3/24
    #  shutdown
    #  speed 1000
    # interface ge3
    #  description Configured and Overridden by Ansible Network
    #  ip address dhcp
    #  shutdown
    #  speed 1000
    # interface ge3.100
    # interface ge4
    #  no ip address
    #  shutdown


    # Using overridden

    # Before state:
    # -------------
    #
    # Router# show running-config | section ^interface
    # interface loopback999
    #  no ip address
    #  shutdown
    # interface ge1
    #  description Management interface do not change
    #  ip address dhcp
    # interface ge2
    #  ip address 192.168.0.3/24
    #  shutdown
    #  speed 1000
    # interface ge3
    #  description Configured and Overridden by Ansible Network
    #  ip address dhcp
    #  shutdown
    #  speed 1000
    # interface ge3.100
    # interface ge4
    #  no ip address
    #  shutdown

    - name: Override device configuration of all interfaces with provided configuration
      amnesh.soodar.soodar_l3_interfaces:
        config:
          - ipv4:
              - dhcp:
                  enable: true
            name: ge1
          - name: ge2
            ipv4:
              - address: 192.168.0.1/24
          - name: ge3
        state: overridden

    # Task Output
    # -----------
    # before:
    # - ipv4:
    #   - dhcp:
    #       enable: true
    #   name: ge1
    # - ipv4:
    #   - address: 192.168.0.3/24
    #   name: ge2
    # - ipv4:
    #   - dhcp:
    #       client_id: ge2
    #       enable: true
    #   name: ge3
    # - name: ge3.100
    # - name: ge4
    # - name: loopback999
    # commands:
    # - interface ge2
    # - ip address 192.168.0.1/24
    # - no ip address 192.168.0.3/24
    # - interface ge3
    # - no ip address dhcp
    # after:
    # - ipv4:
    #   - dhcp:
    #       enable: true
    #   name: ge1
    # - ipv4:
    #   - address: 192.168.0.1/24
    #   name: ge2
    # - name: ge3
    # - name: ge3.100
    # - name: ge4
    # - name: loopback999

    # After state:
    # ------------
    #
    # Router# show running-config | section ^interface
    # interface loopback999
    #  no ip address
    #  shutdown
    # interface ge1
    #  description Management interface do not change
    #  ip address dhcp
    # interface ge2
    #  ip address 192.168.0.1/24
    #  shutdown
    #  speed 1000
    # interface ge3
    #  description Configured and Overridden by Ansible Network
    #  no ip address
    #  shutdown
    #  speed 1000
    # interface ge3.100
    # interface ge4
    #  no ip address
    #  shutdown


    # Using deleted

    # Before state:
    # -------------
    #
    # Router# show running-config | section ^interface
    # interface loopback999
    #  no ip address
    #  shutdown
    # interface ge1
    #  description Management interface do not change
    #  ip address dhcp
    # interface ge2
    #  ip address 192.168.0.1/24
    #  shutdown
    #  speed 1000
    # interface ge3
    #  description Configured and Overridden by Ansible Network
    #  no ip address
    #  shutdown
    #  speed 1000
    # interface ge3.100
    # interface ge4
    #  no ip address
    #  shutdown

    - name: "Delete attributes of given interfaces (NOTE: This won't delete the interfaces)"
      amnesh.soodar.soodar_l3_interfaces:
        config:
          - name: ge2
          - name: ge3.100
        state: deleted

    # Task Output
    # -----------
    #
    # before:
    # - ipv4:
    #   - dhcp:
    #       enable: true
    #   name: ge1
    # - ipv4:
    #   - address: 192.168.0.1/24
    #   name: ge2
    # - name: ge3
    # - name: ge3.100
    # - name: ge4
    # - name: loopback999
    # commands:
    # - interface ge2
    # - no ip address 192.168.0.1/24
    # after:
    # - ipv4:
    #   - dhcp:
    #       enable: true
    #   name: ge1
    # - name: ge2
    # - name: ge3
    # - name: ge3.100
    # - name: ge4
    # - name: loopback999

    # After state:
    # -------------
    #
    # Router# show running-config | section ^interface
    # interface loopback999
    #  no ip address
    #  shutdown
    # interface ge1
    #  description Management interface do not change
    #  ip address dhcp
    # interface ge2
    #  no ip address
    #  shutdown
    #  speed 1000
    # interface ge3
    #  description Configured and Overridden by Ansible Network
    #  no ip address
    #  shutdown
    #  speed 1000
    # interface ge3.100
    # interface ge4
    #  no ip address
    #  shutdown

    # Using deleted without config passed, only interface's configuration will be negated

    # Before state:
    # -------------

    # Router# show running-config | section ^interface
    # interface loopback999
    #  no ip address
    #  shutdown
    # interface ge1
    #  description Management interface do not change
    #  ip address dhcp
    # interface ge2
    #  ip address 192.168.0.2/24
    #  shutdown
    #  speed 1000
    # interface ge3
    #  description Configured and Overridden by Ansible Network
    #  no ip address
    #  shutdown
    #  speed 1000
    #  ipv6 address FD5D:12C9:2201:1::1/64
    # interface ge3.100
    # interface ge4
    #  no ip address
    #  shutdown

    - name: "Delete L3 config of all interfaces"
      amnesh.soodar.soodar_l3_interfaces:
        state: deleted

    # Task Output
    # -----------
    #
    # before:
    # - ipv4:
    #   - dhcp:
    #       enable: true
    #   name: ge1
    # - ipv4:
    #   - address: 192.168.0.2/24
    #   name: ge2
    # - ipv6:
    #   - address: FD5D:12C9:2201:1::1/64
    #   name: ge3
    # - name: ge3.100
    # - name: ge4
    # - name: loopback999
    # commands:
    # - interface ge1
    # - no ip address dhcp
    # - interface ge2
    # - no ip address 192.168.0.2/24
    # - interface ge3
    # - no ipv6 address fd5d:12c9:2201:1::1/64
    # after:
    # - name: ge1
    # - name: ge2
    # - name: ge3
    # - name: ge3.100
    # - name: ge4
    # - name: loopback999

    # After state:
    # -------------
    #
    # interface loopback999
    #  no ip address
    #  shutdown
    # interface ge1
    #  description Management interface do not change
    # interface ge2
    #  shutdown
    #  speed 1000
    # interface ge3
    #  description Configured and Overridden by Ansible Network
    #  no ip address
    #  shutdown
    #  speed 1000
    # interface ge3.100
    # interface ge4
    #  no ip address
    #  shutdown


    # Using gathered

    # Before state:
    # -------------
    #
    # Router# show running-config | section ^interface
    # interface loopback999
    #  no ip address
    #  shutdown
    # interface ge1
    #  description Management interface do not change
    #  ip address dhcp
    # interface ge2
    #  ip address 192.168.0.3/24
    #  shutdown
    #  speed 1000
    # interface ge3
    #  description Configured and Overridden by Ansible Network
    #  ip address dhcp
    #  shutdown
    #  speed 1000
    # interface ge3.100
    # interface ge4
    #  no ip address
    #  shutdown

    - name: Gather facts for l3 interfaces
      amnesh.soodar.soodar_l3_interfaces:
        state: gathered

    # Task Output
    # -----------
    #
    # gathered:
    # - ipv4:
    #   - dhcp:
    #       enable: true
    #   name: ge1
    # - ipv4:
    #   - address: 192.168.0.3/24
    #   name: ge2
    # - ipv4:
    #   - dhcp:
    #       enable: true
    #   name: ge3
    # - name: ge3.100
    # - name: ge4
    # - name: loopback999

    # Using rendered

    - name: Render the commands for provided configuration
      amnesh.soodar.soodar_l3_interfaces:
        config:
          - name: ge1
            ipv4:
              - dhcp:
                  enable: true
          - name: ge2
            ipv4:
              - address: 198.51.100.2/24
            ipv6:
              - address: 2001:db8:0:3::/64
        state: rendered

    # Task Output
    # -----------
    #
    # rendered:
    # - interface ge1
    # - ip address dhcp
    # - interface ge2
    # - ip address 198.51.100.1/24 secondary
    # - ip address 198.51.100.2/24
    # - ipv6 address 2001:db8:0:3::/64

    # Using parsed

    # File: parsed.cfg
    # ----------------
    #
    # interface ge0
    #  ip address dhcp
    # interface ge1
    #  ip address 198.51.100.1/24
    #  ipv6 address 2001:db8:0:3::/64

    - name: Parse the provided configuration
      amnesh.soodar.soodar_l3_interfaces:
        running_config: "{{ lookup('file', 'parsed.cfg') }}"
        state: parsed

    # Task Output
    # -----------
    #
    # parsed:
    # - ipv4:
    #   - dhcp:
    #       enable: true
    #   name: ge0
    # - ipv4:
    #   - address: 198.51.100.2/24
    #   ipv6:
    #   - address: 2001:db8:0:3::/64
    #   name: ge1



.. Facts


.. Return values

Return Values
-------------
Common return values are documented :ref:`here <common_return_values>`, the following are the fields unique to this module:

.. tabularcolumns:: \X{1}{3}\X{2}{3}

.. list-table::
  :width: 100%
  :widths: auto
  :header-rows: 1
  :class: longtable ansible-option-table

  * - Key
    - Description

  * - .. raw:: html

        <div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="return-after"></div>

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__return-after:

      .. rst-class:: ansible-option-title

      **after**

      .. raw:: html

        <a class="ansibleOptionLink" href="#return-after" title="Permalink to this return value"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`dictionary`

      .. raw:: html

        </div>

    - .. raw:: html

        <div class="ansible-option-cell">

      The resulting configuration after module execution.


      .. rst-class:: ansible-option-line

      :ansible-option-returned-bold:`Returned:` when changed

      .. rst-class:: ansible-option-line
      .. rst-class:: ansible-option-sample

      :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"This output will always be in the same format as the module argspec.\\n"`


      .. raw:: html

        </div>


  * - .. raw:: html

        <div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="return-before"></div>

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__return-before:

      .. rst-class:: ansible-option-title

      **before**

      .. raw:: html

        <a class="ansibleOptionLink" href="#return-before" title="Permalink to this return value"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`dictionary`

      .. raw:: html

        </div>

    - .. raw:: html

        <div class="ansible-option-cell">

      The configuration prior to the module execution.


      .. rst-class:: ansible-option-line

      :ansible-option-returned-bold:`Returned:` when :emphasis:`state` is :literal:`merged`\ , :literal:`replaced`\ , :literal:`overridden`\ , :literal:`deleted` or :literal:`purged`

      .. rst-class:: ansible-option-line
      .. rst-class:: ansible-option-sample

      :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"This output will always be in the same format as the module argspec.\\n"`


      .. raw:: html

        </div>


  * - .. raw:: html

        <div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="return-commands"></div>

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__return-commands:

      .. rst-class:: ansible-option-title

      **commands**

      .. raw:: html

        <a class="ansibleOptionLink" href="#return-commands" title="Permalink to this return value"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`list` / :ansible-option-elements:`elements=string`

      .. raw:: html

        </div>

    - .. raw:: html

        <div class="ansible-option-cell">

      The set of commands pushed to the remote device.


      .. rst-class:: ansible-option-line

      :ansible-option-returned-bold:`Returned:` when :emphasis:`state` is :literal:`merged`\ , :literal:`replaced`\ , :literal:`overridden`\ , :literal:`deleted` or :literal:`purged`

      .. rst-class:: ansible-option-line
      .. rst-class:: ansible-option-sample

      :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`["sample command 1", "sample command 2", "sample command 3"]`


      .. raw:: html

        </div>


  * - .. raw:: html

        <div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="return-gathered"></div>

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__return-gathered:

      .. rst-class:: ansible-option-title

      **gathered**

      .. raw:: html

        <a class="ansibleOptionLink" href="#return-gathered" title="Permalink to this return value"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`list` / :ansible-option-elements:`elements=string`

      .. raw:: html

        </div>

    - .. raw:: html

        <div class="ansible-option-cell">

      Facts about the network resource gathered from the remote device as structured data.


      .. rst-class:: ansible-option-line

      :ansible-option-returned-bold:`Returned:` when :emphasis:`state` is :literal:`gathered`

      .. rst-class:: ansible-option-line
      .. rst-class:: ansible-option-sample

      :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`["This output will always be in the same format as the module argspec.\\n"]`


      .. raw:: html

        </div>


  * - .. raw:: html

        <div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="return-parsed"></div>

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__return-parsed:

      .. rst-class:: ansible-option-title

      **parsed**

      .. raw:: html

        <a class="ansibleOptionLink" href="#return-parsed" title="Permalink to this return value"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`list` / :ansible-option-elements:`elements=string`

      .. raw:: html

        </div>

    - .. raw:: html

        <div class="ansible-option-cell">

      The device native config provided in :emphasis:`running\_config` option parsed into structured data as per module argspec.


      .. rst-class:: ansible-option-line

      :ansible-option-returned-bold:`Returned:` when :emphasis:`state` is :literal:`parsed`

      .. rst-class:: ansible-option-line
      .. rst-class:: ansible-option-sample

      :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`["This output will always be in the same format as the module argspec.\\n"]`


      .. raw:: html

        </div>


  * - .. raw:: html

        <div class="ansible-option-cell">
        <div class="ansibleOptionAnchor" id="return-rendered"></div>

      .. _ansible_collections.amnesh.soodar.soodar_l3_interfaces_module__return-rendered:

      .. rst-class:: ansible-option-title

      **rendered**

      .. raw:: html

        <a class="ansibleOptionLink" href="#return-rendered" title="Permalink to this return value"></a>

      .. ansible-option-type-line::

        :ansible-option-type:`list` / :ansible-option-elements:`elements=string`

      .. raw:: html

        </div>

    - .. raw:: html

        <div class="ansible-option-cell">

      The provided configuration in the task rendered in device\-native format (offline).


      .. rst-class:: ansible-option-line

      :ansible-option-returned-bold:`Returned:` when :emphasis:`state` is :literal:`rendered`

      .. rst-class:: ansible-option-line
      .. rst-class:: ansible-option-sample

      :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`["sample command 1", "sample command 2", "sample command 3"]`


      .. raw:: html

        </div>



..  Status (Presently only deprecated)


.. Authors

Authors
~~~~~~~

- Sagar Paul (@KB-perByte)
- Sumit Jaiswal (@justjais)
- Mahdi Varasteh (@m-varasteh)


.. Extra links

Collection links
~~~~~~~~~~~~~~~~

.. ansible-links::

  - title: "Issue Tracker"
    url: "http://soodar.ir/issue/tracker"
    external: true
  - title: "Homepage"
    url: "http://soodar.ir"
    external: true


.. Parsing errors