draft-ietf-netconf-netconf-event-notifications-12.txt   draft-ietf-netconf-netconf-event-notifications-13.txt 
skipping to change at page 1, line 15 skipping to change at page 1, line 15
Intended status: Standards Track A. Clemm Intended status: Standards Track A. Clemm
Expires: April 7, 2019 Huawei Expires: April 7, 2019 Huawei
A. Gonzalez Prieto A. Gonzalez Prieto
Microsoft Microsoft
E. Nilsen-Nygaard E. Nilsen-Nygaard
A. Tripathy A. Tripathy
Cisco Systems Cisco Systems
October 4, 2018 October 4, 2018
NETCONF Support for Event Notifications NETCONF Support for Event Notifications
draft-ietf-netconf-netconf-event-notifications-12 draft-ietf-netconf-netconf-event-notifications-13
Abstract Abstract
This document provides a NETCONF binding to the dynamic subscription This document provides a NETCONF binding to the dynamic subscription
capability of both subscribed notifications and YANG push. capability of both subscribed notifications and YANG push.
RFC Editor note: please replace the four references to pre-RFC RFC Editor note: please replace the four references to pre-RFC
normative drafts with the actual assigned RFC numbers. normative drafts with the actual assigned RFC numbers.
Status of This Memo Status of This Memo
skipping to change at page 2, line 32 skipping to change at page 2, line 32
10. Notes to the RFC Editor . . . . . . . . . . . . . . . . . . . 6 10. Notes to the RFC Editor . . . . . . . . . . . . . . . . . . . 6
11. References . . . . . . . . . . . . . . . . . . . . . . . . . 6 11. References . . . . . . . . . . . . . . . . . . . . . . . . . 6
11.1. Normative References . . . . . . . . . . . . . . . . . . 6 11.1. Normative References . . . . . . . . . . . . . . . . . . 6
11.2. Informative References . . . . . . . . . . . . . . . . . 7 11.2. Informative References . . . . . . . . . . . . . . . . . 7
Appendix A. Examples . . . . . . . . . . . . . . . . . . . . . . 7 Appendix A. Examples . . . . . . . . . . . . . . . . . . . . . . 7
A.1. Event Stream Discovery . . . . . . . . . . . . . . . . . 7 A.1. Event Stream Discovery . . . . . . . . . . . . . . . . . 7
A.2. Dynamic Subscriptions . . . . . . . . . . . . . . . . . . 8 A.2. Dynamic Subscriptions . . . . . . . . . . . . . . . . . . 8
A.3. Subscription State Notifications . . . . . . . . . . . . 12 A.3. Subscription State Notifications . . . . . . . . . . . . 12
A.4. Filter Examples . . . . . . . . . . . . . . . . . . . . . 14 A.4. Filter Examples . . . . . . . . . . . . . . . . . . . . . 14
Appendix B. Changes between revisions . . . . . . . . . . . . . 15 Appendix B. Changes between revisions . . . . . . . . . . . . . 15
B.1. v11 to v12 . . . . . . . . . . . . . . . . . . . . . . . 15 B.1. v11 to v13 . . . . . . . . . . . . . . . . . . . . . . . 15
B.2. v10 to v11 . . . . . . . . . . . . . . . . . . . . . . . 16 B.2. v10 to v11 . . . . . . . . . . . . . . . . . . . . . . . 16
B.3. v09 to v10 . . . . . . . . . . . . . . . . . . . . . . . 16 B.3. v09 to v10 . . . . . . . . . . . . . . . . . . . . . . . 16
B.4. v08 to v09 . . . . . . . . . . . . . . . . . . . . . . . 16 B.4. v08 to v09 . . . . . . . . . . . . . . . . . . . . . . . 16
B.5. v07 to v08 . . . . . . . . . . . . . . . . . . . . . . . 16 B.5. v07 to v08 . . . . . . . . . . . . . . . . . . . . . . . 16
B.6. v06 to v07 . . . . . . . . . . . . . . . . . . . . . . . 16 B.6. v06 to v07 . . . . . . . . . . . . . . . . . . . . . . . 16
B.7. v05 to v06 . . . . . . . . . . . . . . . . . . . . . . . 16 B.7. v05 to v06 . . . . . . . . . . . . . . . . . . . . . . . 16
B.8. v03 to v04 . . . . . . . . . . . . . . . . . . . . . . . 16 B.8. v03 to v04 . . . . . . . . . . . . . . . . . . . . . . . 16
B.9. v01 to v03 . . . . . . . . . . . . . . . . . . . . . . . 17 B.9. v01 to v03 . . . . . . . . . . . . . . . . . . . . . . . 17
B.10. v00 to v01 . . . . . . . . . . . . . . . . . . . . . . . 17 B.10. v00 to v01 . . . . . . . . . . . . . . . . . . . . . . . 17
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 17 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 17
skipping to change at page 9, line 9 skipping to change at page 9, line 9
Figure 2: Multiple subscriptions over a NETCONF session Figure 2: Multiple subscriptions over a NETCONF session
To provide examples of the information being transported, example To provide examples of the information being transported, example
messages for interactions (a) and (b) in Figure 2 are detailed below: messages for interactions (a) and (b) in Figure 2 are detailed below:
<rpc message-id="102" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <rpc message-id="102" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<establish-subscription <establish-subscription
xmlns="urn:ietf:params:xml:ns:yang:ietf-subscribed-notifications"> xmlns="urn:ietf:params:xml:ns:yang:ietf-subscribed-notifications">
<stream>NETCONF</stream> <stream>NETCONF</stream>
<stream-xpath-filter xmlns:ex="http://example.com/events"> <stream-xpath-filter xmlns:ds="http://example.com/events">
/ex:foo/ /ds:foo/
</stream-xpath-filter> </stream-xpath-filter>
<dscp>10</dscp> <dscp>10</dscp>
</establish-subscription> </establish-subscription>
</rpc> </rpc>
Figure 3: establish-subscription request (a) Figure 3: establish-subscription request (a)
As NETCONF publisher was able to fully satisfy the request (a), the As NETCONF publisher was able to fully satisfy the request (a), the
publisher sends the subscription "id" of the accepted subscription publisher sends the subscription "id" of the accepted subscription
within message (b): within message (b):
skipping to change at page 11, line 11 skipping to change at page 11, line 11
request made in (c) may look like that shown in Figure 7. As can be request made in (c) may look like that shown in Figure 7. As can be
seen, the modifications being attempted are the application of a new seen, the modifications being attempted are the application of a new
xpath filter as well as the setting of a new periodic time interval. xpath filter as well as the setting of a new periodic time interval.
<rpc message-id="303" <rpc message-id="303"
xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<modify-subscription <modify-subscription
xmlns="urn:ietf:params:xml:ns:yang:ietf-subscribed-notifications" xmlns="urn:ietf:params:xml:ns:yang:ietf-subscribed-notifications"
xmlns:yp="urn:ietf:params:xml:ns:yang:ietf-yang-push"> xmlns:yp="urn:ietf:params:xml:ns:yang:ietf-yang-push">
<id>23</id> <id>23</id>
<yp:datastore-xpath-filter xmlns="http://example.com/datastore"> <yp:datastore-xpath-filter xmlns:ds="http://example.com/datastore">
/interfaces-state/interface/oper-status /ds:foo/ds:bar
</yp:datastore-xpath-filter> </yp:datastore-xpath-filter>
<yp:periodic> <yp:periodic>
<yp:period>500</yp:period> <yp:period>500</yp:period>
</yp:periodic> </yp:periodic>
</modify-subscription> </modify-subscription>
</rpc> </rpc>
Figure 7: Subscription modification request (c) Figure 7: Subscription modification request (c)
If the NETCONF publisher can satisfy both changes, the publisher If the NETCONF publisher can satisfy both changes, the publisher
skipping to change at page 15, line 46 skipping to change at page 15, line 46
</rpc> </rpc>
Figure 16 Figure 16
For more examples of subtree filters, see [RFC6241], section 6.4. For more examples of subtree filters, see [RFC6241], section 6.4.
Appendix B. Changes between revisions Appendix B. Changes between revisions
(To be removed by RFC editor prior to publication) (To be removed by RFC editor prior to publication)
B.1. v11 to v12 B.1. v11 to v13
o Subscription identifier renamed to id. o Subscription identifier renamed to id.
o Appendix A.4 for filter examples o Appendix A.4 for filter examples
o for v13, Tweak of example to /foo/bar
B.2. v10 to v11 B.2. v10 to v11
o Configured removed. o Configured removed.
B.3. v09 to v10 B.3. v09 to v10
o Tweaks to examples and text. o Tweaks to examples and text.
o Downshifted state names. o Downshifted state names.
o Removed address from examples. o Removed address from examples.
 End of changes. 6 change blocks. 
7 lines changed or deleted 8 lines changed or added

This html diff was produced by rfcdiff 1.47. The latest version is available from http://tools.ietf.org/tools/rfcdiff/