junos_l3_interface - Manage L3 interfaces on Juniper JUNOS network devices
New in version 2.4.
Synopsis
- This module provides declarative management of L3 interfaces on Juniper JUNOS network devices.
Requirements (on host that executes module)
- ncclient (>=v0.5.2)
Options
parameter | required | default | choices | comments |
---|---|---|---|---|
active | no | True |
| Specifies whether or not the configuration is active or deactivated |
aggregate | no | List of L3 interfaces definitions | ||
ipv4 | no | IPv4 of the L3 interface. | ||
ipv6 | no | IPv6 of the L3 interface. | ||
name | no | Name of the L3 interface. | ||
state | no | present |
| State of the L3 interface configuration. |
unit | no | Logical interface number. |
Examples
- name: Set ge-0/0/1 IPv4 address junos_l3_interface: name: ge-0/0/1 ipv4: 192.168.0.1 - name: Remove ge-0/0/1 IPv4 address junos_l3_interface: name: ge-0/0/1 state: absent - name: Set ipv4 address using aggregate junos_l3_interface: aggregate: - name: ge-0/0/1 ipv4: 1.1.1.1 - name: ge-0/0/2 ipv4: 2.2.2.2 ipv6: fd5d:12c9:2201:2::2 - name: Delete ipv4 address using aggregate junos_l3_interface: aggregate: - name: ge-0/0/1 ipv4: 1.1.1.1 - name: ge-0/0/2 ipv4: 2.2.2.2 state: absent
Return Values
Common return values are documented here Return Values, the following are the fields unique to this module:
name | description | returned | type | sample |
---|---|---|---|---|
diff | Configuration difference before and after applying change. | when configuration is changed and diff option is enabled. | string | [edit interfaces ge-0/0/1 unit 0 family inet] + address 1.1.1.1/32; [edit interfaces ge-0/0/1 unit 0 family inet6] + address fd5d:12c9:2201:1::1/128; |
Notes
Note
- This module requires the netconf system service be enabled on the remote device being managed.
- Tested against vSRX JUNOS version 15.1X49-D15.4, vqfx-10000 JUNOS Version 15.1X53-D60.4.
Status
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Maintenance Info
For more information about Red Hat’s this support of this module, please refer to this knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/junos_l3_interface_module.html