Try SpotterFetch configuration/state data from NETCONF enabled network devices.
| "added in version" 2.6 of ansible.builtin"
Authors: Ganesh Nalawade (@ganeshrn), Sven Wisotzky (@wisotzky)
preview | supported by network
pipInstall with pip install ansible==2.6.2
NETCONF is a network management protocol developed and standardized by the IETF. It is documented in RFC 6241.
This module allows the user to fetch configuration and state data from NETCONF enabled network devices.
- name: Get running configuration and state data netconf_get:
- name: Get configuration and state data from startup datastore
netconf_get:
source: startup
- name: Get system configuration data from running datastore state (junos)
netconf_get:
source: running
filter: <configuration><system></system></configuration>
- name: Get configuration and state data in JSON format
netconf_get:
display: json
- name: get schema list using subtree w/ namespaces
netconf_get:
format: json
filter: <netconf-state xmlns="urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring"><schemas><schema/></schemas></netconf-state>
lock: False
- name: get schema list using xpath
netconf_get:
format: json
filter: /netconf-state/schemas/schema
- name: get interface confiugration with filter (iosxr)
netconf_get:
filter: <interface-configurations xmlns="http://cisco.com/ns/yang/Cisco-IOS-XR-ifmgr-cfg"></interface-configurations>
- name: Get system configuration data from running datastore state (sros)
netconf_get:
source: running
filter: <state xmlns="urn:nokia.com:sros:ns:yang:sr:conf"/>
lock: True
- name: Get state data (sros)
netconf_get:
filter: <state xmlns="urn:nokia.com:sros:ns:yang:sr:state"/>
lock:
choices:
- never
- always
- if-supported
default: never
description:
- Instructs the module to explicitly lock the datastore specified as C(source) before
fetching configuration and/or state information from remote host. If the value is
I(never) in that case the C(source) datastore is never locked, if the value is I(if-supported)
the C(source) datastore is locked only if the Netconf server running on remote host
supports locking of that datastore, if the lock on C(source) datastore is not supported
module will report appropriate error before executing lock. If the value is I(always)
the lock operation on C(source) datastore will always be executed irrespective if
the remote host supports it or not, if it doesn't the module with fail will the
execption message received from remote host and might vary based on the platform.
filter:
description:
- This argument specifies the XML string which acts as a filter to restrict the portions
of the data to be are retrieved from the remote device. If this option is not specified
entire configuration or state data is returned in result depending on the value
of C(source) option. The C(filter) value can be either XML string or XPath, if the
filter is in XPath format the NETCONF server running on remote host should support
xpath capability else it will result in an error.
source:
choices:
- running
- candidate
- startup
description:
- This argument specifies the datastore from which configuration data should be fetched.
Valid values are I(running), I(candidate) and I(startup). If the C(source) value
is not set both configuration and state information are returned in response from
running datastore.
display:
choices:
- json
- pretty
- xml
description:
- Encoding scheme to use when serializing output from the device. The option I(json)
will serialize the output as JSON data. If the option value is I(json) it requires
jxmlease to be installed on control node. The option I(pretty) is similar to received
XML response but is using human readable format (spaces, new lines). The option
value I(xml) is similar to received XML response but removes all XML namespaces.
output:
contains:
formatted_output:
- Contains formatted response received from remote host as per the value in display
format.
description: Based on the value of display option will return either the set of
transformed XML to JSON format from the RPC response with type dict or pretty
XML string response (human-readable) or response with namespace removed from XML
string.
returned: when the display format is selected as JSON it is returned as dict type,
if the display format is xml or pretty pretty it is retured as a string apart
from low-level errors (such as action plugin).
type: complex
stdout:
description: The raw XML string containing configuration or state data received
from the underlying ncclient library.
returned: always apart from low-level errors (such as action plugin)
sample: '...'
type: string
stdout_lines:
description: The value of stdout split into a list
returned: always apart from low-level errors (such as action plugin)
sample:
- '...'
- '...'
type: list