NETCONF Event Notifications
RFC 5277
Document | Type | RFC - Proposed Standard (July 2008; No errata) | |
---|---|---|---|
Authors | Hector Trevino , Sharon Chisholm | ||
Last updated | 2015-10-14 | ||
Stream | Internent Engineering Task Force (IETF) | ||
Formats | plain text html pdf htmlized (tools) htmlized bibtex | ||
Reviews | |||
Stream | WG state | (None) | |
Document shepherd | No shepherd assigned | ||
IESG | IESG state | RFC 5277 (Proposed Standard) | |
Action Holders |
(None)
|
||
Consensus Boilerplate | Unknown | ||
Telechat date | |||
Responsible AD | Dan Romascanu | ||
Send notices to | bertietf@bwijnen.net |
Network Working Group S. Chisholm Request for Comments: 5277 Nortel Category: Standards Track H. Trevino Cisco July 2008 NETCONF Event Notifications Status of This Memo This document specifies an Internet standards track protocol for the Internet community, and requests discussion and suggestions for improvements. Please refer to the current edition of the "Internet Official Protocol Standards" (STD 1) for the standardization state and status of this protocol. Distribution of this memo is unlimited. Abstract This document defines mechanisms that provide an asynchronous message notification delivery service for the Network Configuration protocol (NETCONF). This is an optional capability built on top of the base NETCONF definition. This document defines the capabilities and operations necessary to support this service. Chisholm & Trevino Standards Track [Page 1] RFC 5277 NETCONF Event Notifications July 2008 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1. Definition of Terms . . . . . . . . . . . . . . . . . . . 3 1.2. Motivation . . . . . . . . . . . . . . . . . . . . . . . . 4 1.3. Event Notifications in NETCONF . . . . . . . . . . . . . . 5 2. Notification-Related Operations . . . . . . . . . . . . . . . 5 2.1. Subscribing to Receive Event Notifications . . . . . . . . 5 2.1.1. <create-subscription> . . . . . . . . . . . . . . . . 6 2.2. Sending Event Notifications . . . . . . . . . . . . . . . 9 2.2.1. <notification> . . . . . . . . . . . . . . . . . . . . 9 2.3. Terminating the Subscription . . . . . . . . . . . . . . . 9 3. Supporting Concepts . . . . . . . . . . . . . . . . . . . . . 10 3.1. Capabilities Exchange . . . . . . . . . . . . . . . . . . 10 3.1.1. Capability Identifier . . . . . . . . . . . . . . . . 10 3.1.2. Capability Example . . . . . . . . . . . . . . . . . . 10 3.2. Event Streams . . . . . . . . . . . . . . . . . . . . . . 10 3.2.1. Event Stream Definition . . . . . . . . . . . . . . . 12 3.2.2. Event Stream Content Format . . . . . . . . . . . . . 12 3.2.3. Default Event Stream . . . . . . . . . . . . . . . . . 12 3.2.4. Event Stream Sources . . . . . . . . . . . . . . . . . 12 3.2.5. Event Stream Discovery . . . . . . . . . . . . . . . . 12 3.3. Notification Replay . . . . . . . . . . . . . . . . . . . 15 3.3.1. Overview . . . . . . . . . . . . . . . . . . . . . . . 15 3.3.2. Creating a Subscription with Replay . . . . . . . . . 16 3.4. Notification Management Schema . . . . . . . . . . . . . . 16 3.5. Subscriptions Data . . . . . . . . . . . . . . . . . . . . 20 3.6. Filter Mechanics . . . . . . . . . . . . . . . . . . . . . 20 3.6.1. Filtering . . . . . . . . . . . . . . . . . . . . . . 20 3.7. Message Flow . . . . . . . . . . . . . . . . . . . . . . . 20 4. XML Schema for Event Notifications . . . . . . . . . . . . . . 22 5. Filtering Examples . . . . . . . . . . . . . . . . . . . . . . 26 5.1. Subtree Filtering . . . . . . . . . . . . . . . . . . . . 28 5.2. XPATH Filters . . . . . . . . . . . . . . . . . . . . . . 29 6. Interleave Capability . . . . . . . . . . . . . . . . . . . . 30 6.1. Description . . . . . . . . . . . . . . . . . . . . . . . 30 6.2. Dependencies . . . . . . . . . . . . . . . . . . . . . . . 30 6.3. Capability Identifier . . . . . . . . . . . . . . . . . . 30 6.4. New Operations . . . . . . . . . . . . . . . . . . . . . . 31 6.5. Modifications to Existing Operations . . . . . . . . . . . 31 7. Security Considerations . . . . . . . . . . . . . . . . . . . 31 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 32 9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 33 10. Normative References . . . . . . . . . . . . . . . . . . . . . 33 Chisholm & Trevino Standards Track [Page 2] RFC 5277 NETCONF Event Notifications July 2008 1. Introduction [NETCONF] can be conceptually partitioned into four layers: Layer Example +-------------+ +-------------------------------------------+ | Content | | Configuration data | +-------------+ +-------------------------------------------+ | | +-------------+ +-------------------------------------------+Show full document text