junipernetworks.junos.junos_netconf module – Configures the Junos Netconf system service
Note
This module is part of the junipernetworks.junos collection (version 8.0.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install junipernetworks.junos
.
To use it in a playbook, specify: junipernetworks.junos.junos_netconf
.
New in junipernetworks.junos 1.0.0
Synopsis
This module provides an abstraction that enables and configures the netconf system service running on Junos devices. This module can be used to easily enable the Netconf API. Netconf provides a programmatic interface for working with configuration and state resources as defined in RFC 6242. If the
netconf_port
is not mentioned in the task by default netconf will be enabled on port 830 only.
Aliases: netconf
Parameters
Parameter |
Comments |
---|---|
This argument specifies the port the netconf service should listen on for SSH connections. The default port as defined in RFC 6242 is 830. Default: |
|
Specifies the state of the Choices:
|
Notes
Note
Tested against vSRX JUNOS version 15.1X49-D15.4, vqfx-10000 JUNOS Version 15.1X53-D60.4.
Recommended connection is
network_cli
. See the Junos OS Platform Options.This module also works with
local
connections for legacy playbooks.If
netconf_port
value is not mentioned in task by default it will be enabled on port 830 only. Althoughnetconf_port
value can be from 1 through 65535, avoid configuring access on a port that is normally assigned for another service. This practice avoids potential resource conflicts.For information on using CLI and netconf see the :ref:`Junos OS Platform Options guide <junos_platform_options>`
For more information on using Ansible to manage network devices see the :ref:`Ansible Network Guide <network_guide>`
For more information on using Ansible to manage Juniper network devices see https://www.ansible.com/ansible-juniper.
Examples
- name: enable netconf service on port 830
junipernetworks.junos.junos_netconf:
listens_on: 830
state: present
- name: disable netconf service
junipernetworks.junos.junos_netconf:
state: absent
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
Returns the command sent to the remote device Returned: when changed is True Sample: |