ansible / ansible.netcommon / 6.1.0 / module / netconf_rpc Execute operations on NETCONF enabled network devices. | "added in version" 1.0.0 of ansible.netcommon" Authors: Ganesh Nalawade (@ganeshrn), Sven Wisotzky (@wisotzky)ansible.netcommon.netconf_rpc (6.1.0) — module
Install with ansible-galaxy collection install ansible.netcommon:==6.1.0
collections: - name: ansible.netcommon version: 6.1.0
NETCONF is a network management protocol developed and standardized by the IETF. It is documented in RFC 6241.
This module allows the user to execute NETCONF RPC requests as defined by IETF RFC standards as well as proprietary requests.
- name: lock candidate ansible.netcommon.netconf_rpc: rpc: lock content: target: candidate:
- name: unlock candidate ansible.netcommon.netconf_rpc: rpc: unlock xmlns: urn:ietf:params:xml:ns:netconf:base:1.0 content: "{'target': {'candidate': None}}"
- name: discard changes ansible.netcommon.netconf_rpc: rpc: discard-changes
- name: get-schema ansible.netcommon.netconf_rpc: rpc: get-schema xmlns: urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring content: identifier: ietf-netconf version: '2011-06-01'
- name: copy running to startup ansible.netcommon.netconf_rpc: rpc: copy-config content: source: running: target: startup:
- name: get schema list with JSON output ansible.netcommon.netconf_rpc: rpc: get content: | <filter> <netconf-state xmlns="urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring"> <schemas/> </netconf-state> </filter> display: json
- name: get schema using XML request ansible.netcommon.netconf_rpc: rpc: get-schema xmlns: urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring content: | <identifier>ietf-netconf-monitoring</identifier> <version>2010-10-04</version> display: json
rpc: description: - This argument specifies the request (name of the operation) to be executed on the remote NETCONF enabled device. required: true type: str xmlns: description: - NETCONF operations not defined in rfc6241 typically require the appropriate XML namespace to be set. In the case the I(request) option is not already provided in XML format, the namespace can be defined by the I(xmlns) option. type: str content: description: - This argument specifies the optional request content (all RPC attributes). The I(content) value can either be provided as XML formatted string or as dictionary. type: str 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. type: str
output: contains: formatted_output: description: - Contains formatted response received from remote host as per the value in display format. type: str 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 returned 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: str 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