Subscription to YANG Notifications for Datastore Updates
RFC 8641
|
Document |
Type |
|
RFC - Proposed Standard
(September 2019; No errata)
|
|
Authors |
|
Alexander Clemm
,
Eric Voit
|
|
Last updated |
|
2019-09-09
|
|
Replaces |
|
draft-clemm-netconf-yang-push
|
|
Stream |
|
IETF
|
|
Formats |
|
plain text
html
pdf
htmlized
bibtex
|
|
Yang Validation |
|
☯
7 errors, 2 warnings.
draft-ietf-netconf-yang-push-25.txt:
xym 0.4:
Extracting 'ietf-yang-push@2019-05-21.yang'
Removed 1 empty lines
ietf-yang-push@2019-05-21.yang:
pyang 1.7.8: pyang --verbose --ietf -p {libs} {model}:
# read ietf-yang-push@2019-05-21.yang (CL)
# read /a/www/ietf-datatracker/6.100.0/env/share/yang/modules/ietf/ietf-yang-types.yang
# read /a/www/ietf-ftp/yang/draftmod/ietf-yang-types@2019-07-21.yang
# read /a/www/ietf-ftp/yang/draftmod/ietf-subscribed-notifications@2019-05-06.yang
# read /a/www/ietf-datatracker/6.100.0/env/share/yang/modules/ietf/ietf-inet-types.yang
# read /a/www/ietf-ftp/yang/draftmod/ietf-inet-types@2019-07-021.yang
# read /a/www/ietf-datatracker/6.100.0/env/share/yang/modules/ietf/ietf-interfaces.yang
# read /a/www/ietf-ftp/yang/rfcmod/ietf-interfaces@2018-02-20.yang
# read /a/www/ietf-datatracker/6.100.0/env/share/yang/modules/ietf/ietf-netconf-acm.yang
# read /a/www/ietf-ftp/yang/rfcmod/ietf-netconf-acm@2018-02-14.yang
# read /a/www/ietf-ftp/yang/rfcmod/ietf-network-instance@2019-01-21.yang
# read /a/www/ietf-datatracker/6.100.0/env/share/yang/modules/ietf/ietf-ip.yang
# read /a/www/ietf-ftp/yang/rfcmod/ietf-ip@2018-02-22.yang
# READ /a/www/ietf-ftp/yang/draftmod/ietf-inet-types@2019-07-021.yang
# read /a/www/ietf-ftp/yang/rfcmod/ietf-yang-schema-mount@2019-01-14.yang
# READ /a/www/ietf-ftp/yang/draftmod/ietf-inet-types@2019-07-021.yang
# read /a/www/ietf-ftp/yang/rfcmod/ietf-restconf.yang
# read /a/www/ietf-datatracker/6.100.0/env/share/yang/modules/ietf/ietf-restconf.yang
# read /a/www/ietf-datatracker/6.100.0/env/share/yang/modules/ietf/ietf-datastores.yang
# read /a/www/ietf-ftp/yang/rfcmod/ietf-datastores@2018-02-14.yang
# read /a/www/ietf-ftp/yang/rfcmod/ietf-yang-patch.yang
# read /a/www/ietf-datatracker/6.100.0/env/share/yang/modules/ietf/ietf-yang-patch.yang
/a/www/ietf-ftp/yang/draftmod/ietf-inet-types@2019-07-021.yang:1: warning: filename "/a/www/ietf-ftp/yang/draftmod/ietf-inet-types@2019-07-021.yang" suggests invalid revision "2019-07-021", should match "YYYY-MM-DD"
/a/www/ietf-ftp/yang/draftmod/ietf-inet-types@2019-07-021.yang:1: warning: filename "/a/www/ietf-ftp/yang/draftmod/ietf-inet-types@2019-07-021.yang" suggests invalid revision "2019-07-021", should match "YYYY-MM-DD"
yanglint 0.14.80: yanglint --verbose -p {rfclib} -p {draftlib} -p {tmplib} {model} -i:
err : The leafref leaf is config but refers to a non-config leaf. (/ietf-subscribed-notifications:subscriptions/subscription/target/stream/stream)
err : The leafref leaf is config but refers to a non-config leaf. (/ietf-subscribed-notifications:subscriptions/subscription/target/stream/stream)
err : Invalid value "subscription-policy" of "uses". (/ietf-subscribed-notifications:subscriptions/subscription/subscription-policy)
err : Copying data from grouping failed. (/ietf-subscribed-notifications:subscriptions/subscription/subscription-policy)
err : Module "ietf-subscribed-notifications" parsing failed.
err : Importing "ietf-subscribed-notifications" module into "ietf-yang-push" failed.
err : Module "ietf-yang-push" parsing failed.
|
|
Reviews |
|
|
|
Additional Resources |
|
|
Stream |
WG state
|
|
Submitted to IESG for Publication
|
|
Document shepherd |
|
Kent Watsen
|
|
Shepherd write-up |
|
Show
(last changed 2019-02-26)
|
IESG |
IESG state |
|
RFC 8641 (Proposed Standard)
|
|
Consensus Boilerplate |
|
Yes
|
|
Telechat date |
|
|
|
Responsible AD |
|
Ignas Bagdonas
|
|
Send notices to |
|
Kent Watsen <kent+ietf@watsen.net>
|
IANA |
IANA review state |
|
Version Changed - Review Needed
|
|
IANA action state |
|
RFC-Ed-Ack
|
Internet Engineering Task Force (IETF) A. Clemm
Request for Comments: 8641 Futurewei
Category: Standards Track E. Voit
ISSN: 2070-1721 Cisco Systems
September 2019
Subscription to YANG Notifications for Datastore Updates
Abstract
This document describes a mechanism that allows subscriber
applications to request a continuous and customized stream of updates
from a YANG datastore. Providing such visibility into updates
enables new capabilities based on the remote mirroring and monitoring
of configuration and operational state.
Status of This Memo
This is an Internet Standards Track document.
This document is a product of the Internet Engineering Task Force
(IETF). It represents the consensus of the IETF community. It has
received public review and has been approved for publication by the
Internet Engineering Steering Group (IESG). Further information on
Internet Standards is available in Section 2 of RFC 7841.
Information about the current status of this document, any errata,
and how to provide feedback on it may be obtained at
https://www.rfc-editor.org/info/rfc8641.
Clemm & Voit Standards Track [Page 1]
RFC 8641 YANG-Push September 2019
Copyright Notice
Copyright (c) 2019 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents
(https://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License.
This document may contain material from IETF Documents or IETF
Contributions published or made publicly available before November
10, 2008. The person(s) controlling the copyright in some of this
material may not have granted the IETF Trust the right to allow
modifications of such material outside the IETF Standards Process.
Without obtaining an adequate license from the person(s) controlling
the copyright in such materials, this document may not be modified
outside the IETF Standards Process, and derivative works of it may
not be created outside the IETF Standards Process, except to format
it for publication as an RFC or to translate it into languages other
than English.
Clemm & Voit Standards Track [Page 2]
RFC 8641 YANG-Push September 2019
Table of Contents
1. Introduction ....................................................4
2. Definitions .....................................................4
3. Solution Overview ...............................................6
3.1. Subscription Model .........................................6
3.2. Negotiation of Subscription Policies .......................7
3.3. On-Change Considerations ...................................8
3.4. Reliability Considerations .................................9
3.5. Data Encodings ............................................10
3.6. Defining the Selection with a Datastore ...................11
3.7. Streaming Updates .........................................12
3.8. Subscription Management ...................................15
3.9. Receiver Authorization ....................................16
3.10. On-Change Notifiable Datastore Nodes .....................18
3.11. Other Considerations .....................................18
4. A YANG Data Model for Management of Datastore Push
Subscriptions ..................................................20
4.1. Overview ..................................................20
4.2. Subscription Configuration ................................27
4.3. YANG Notifications ........................................28
4.4. YANG RPCs .................................................29
5. YANG Module for YANG-Push ......................................34
6. IANA Considerations ............................................51
7. Security Considerations ........................................51
8. References .....................................................53
8.1. Normative References ......................................53
8.2. Informative References ....................................55
Show full document text