[netconf] YANG Push (RFC 8641) on-change example

["Rob Wilton (rwilton)" <[e-mail]>]

Hi,

The YANG Push RFC provides the following example for an on-change update.

According to the text accompanying the figure 2 in section 3.7, the example is for:

“   Figure 1 provides an example of a notification message for a

   subscription tracking the operational status of a single Ethernet

   interface (per [RFC8343<https://www.rfc-editor.org/rfc/rfc8343>]  This notification message is encoded XML

   [W3C.REC-xml-20081126<https://www.rfc-editor.org/rfc/rfc8641#ref-W3C.REC-xml-20081126>] over …”

The example notification is given as:

  <notification xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">

   <eventTime>2017-10-25T08:22:33.44Z</eventTime>

   <push-change-update

        xmlns="urn:ietf:params:xml:ns:yang:ietf-yang-push">

     <id>89</id>

     <datastore-changes>

       <yang-patch>

         <patch-id>0</patch-id>

         <edit>

           <edit-id>edit1</edit-id>

           <operation>replace</operation>

           <target>/ietf-interfaces:interfaces</target>

           <value>

             <interfaces

                  xmlns="urn:ietf:params:xml:ns:yang:ietf-interfaces">

               <interface>

                 <name>eth0</name>

                 <oper-status>down</oper-status>

               </interface>

             </interfaces>

           </value>

         </edit>

       </yang-patch>

     </datastore-changes>

   </push-change-update>

  </notification>



But I would expect a receiver to interpret this replace operation as replacing the entire operational state for all interfaces with a single eth0 interface entry reporting just the oper-status as down.  Is my interpretation correct?

Instead, I think that the notification target should have identified only the oper-status leaf on the specific interface.  I.e., the generated notification should instead be:


  <notification xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">

   <eventTime>2017-10-25T08:22:33.44Z</eventTime>

   <push-change-update

        xmlns="urn:ietf:params:xml:ns:yang:ietf-yang-push">

     <id>89</id>

     <datastore-changes>

       <yang-patch>

         <patch-id>0</patch-id>

         <edit>

           <edit-id>edit1</edit-id>

           <operation>replace</operation>

           <target>/ietf-interfaces:interfaces/interface=eth0/oper-status</target>

           <value>

             <oper-status xmlns="urn:ietf:params:xml:ns:yang:ietf-interfaces">down</oper-status>

           </value>

         </edit>

       </yang-patch>

     </datastore-changes>

   </push-change-update>

  </notification>

If folks agree, then I can file an errata.

Regards,
Rob