Update user-guide.rst 63/83663/5
authorMario Abraham <mario.abraham@pantheon.tech>
Wed, 14 Aug 2019 10:18:22 +0000 (12:18 +0200)
committerMario Abraham <mario.abraham@pantheon.tech>
Thu, 5 Sep 2019 09:02:33 +0000 (11:02 +0200)
- added info about 2 different endpoints
related to RESTCONF

Issue-ID: NETCONF-500
Signed-off-by: Mario Abraham <mario.abraham@pantheon.tech>
Change-Id: If961757301dffc61dc55f9fc2f580c3632aaeaaa

docs/user-guide.rst

index c2988f849c2fae97c022b3a51b4bdc41346264a4..e8698194bd3fddcb92d43305f7fdce51dd285bc4 100644 (file)
@@ -1,5 +1,13 @@
 .. _netconf-user-guide:
 
+.. |ss| raw:: html
+
+   <strike>
+
+.. |se| raw:: html
+
+   </strike>
+
 NETCONF User Guide
 ==================
 
@@ -78,6 +86,20 @@ This guide focuses on using RESTCONF.
      http://localhost:8181/rests/data/network-topology:network-topology?content=nonconfig
      for operational datastore.
 
+    | Also in case of `RFC-8040 <https://tools.ietf.org/html/rfc8040>`__,
+     if a data node in the path expression is a YANG leaf-list or list
+     node, the path segment has to be constructed by having leaf-list or
+     list node name, followed by an "=" character, then followed by the
+     leaf-list or list value. Any reserved characters must be
+     percent-encoded.
+    | e. g. GET
+     http://localhost:8181/rests/data/network-topology:network-topology/topology=topology-netconf?content=config
+     for retrieving data from configuration datastore for
+     topology-netconf value of topology list is equivalent to the deprecated request
+    | |ss| GET |se|
+     http://localhost:8181/restconf/config/network-topology:network-topology/topology/topology-netconf,
+     which is related to `draft-bierman-netconf-restconf-02
+     <https://tools.ietf.org/html/draft-bierman-netconf-restconf-02>`__.