Input Parameters


The NETCONF <get-config> operation is used for filtered retrieval of configuration data from any datastore.

The NETCONF <get> operation is used for filtered retrieval od any configuration or operational data.


All standard parameters are supported:

  • source (get-config only)
  • filter
  • with-defaults


In addition to these parameters netconfd-pro supports additional filtering parameters not in the NETCONF standard.

These parameters are all optional to use.

  • if-modified-since
  • with-owners
  • depth


if-modified--since Parameter


  • leaf if-modified-since [date-and-time]
    • If this parameter is present, then the server will only process the retrieval request if corresponding 'last-modified' timestamp is more recent than this timestamp. If so, then then retrieval request is processed as normal.  If not, an empty <data> element will be returned.



with-owners Parameter



  • leaf with-owners [empty]
    • Include the 'ywx:owner' attribute in the response for nodes that have stored owner names.  The --save-owners CLI parameter for the server must be set to 'true' for any owner names to be saved.


Example Request using with-owners:


<?xml version="1.0" encoding="UTF-8"?><rpc message-id="6" 
    xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <get-config>
    <source><running/></source>
    <with-owners xmlns="http://yumaworks.com/ns/yumaworks-system"/>
  </get-config>
</rpc>



 Example Response using with-owners:


<?xml version="1.0" encoding="UTF-8"?>
<rpc-reply message-id="6" xmlns:ya="http://yumaworks.com/ns/yumaworks-attrs"
   xmlns:ncx="http://netconfcentral.org/ns/yuma-ncx"
   ncx:last-modified="2017-02-03T18:29:42Z" ncx:etag="23871"
   xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
 <data>
  <int16.1 ya:owner="andy" xmlns="http://netconfcentral.org/ns/test">10</int16.1>
  <int8.1 ya:owner="andy" xmlns="http://netconfcentral.org/ns/test">1</int8.1>
 </data>
</rpc-reply>



depth Parameter


  • leaf depth [union: enumeration uint32] [d:unbounded]
    • The 'depth' parameter is used to specify the number of nest levels returned in a response for a GET method.  The first nest-level consists of the requested data node itself. Any child nodes which are contained within a parent node have a depth value that is 1 greater than its parent.