Self-explanation data Node tag capability
draft-tao-netconf-notif-node-tag-capabilities-02

Document Type Active Internet-Draft (individual)
Last updated 2020-07-08
Stream (None)
Intended RFC status (None)
Formats plain text xml pdf htmlized (tools) htmlized bibtex
Yang Validation 0 errors, 1 warnings.
Additional Resources
- Yang catalog entry for ietf-self-explanation-capabilities@2020-07-08.yang
- Yang impact analysis for draft-tao-netconf-notif-node-tag-capabilities
Stream Stream state (No stream defined)
Consensus Boilerplate Unknown
RFC Editor Note (None)
IESG IESG state I-D Exists
Telechat date
Responsible AD (None)
Send notices to (None)
NETCONF Working Group                                              Q. Wu
Internet-Draft                                                     B. Wu
Intended status: Standards Track                                  Huawei
Expires: January 9, 2021                                          P. Liu
                                                                  H. Cai
                                                            China Mobile
                                                            July 8, 2020

               Self-explanation data Node tag capability
            draft-tao-netconf-notif-node-tag-capabilities-02

Abstract

   Before a client application subscribes to updates from a datastore,
   server capabilities related to "Subscription to YANG Datastores" can
   be advertised using YANG Instance Data format.  These server
   capabilities can be documented at implement time or reported at run-
   time.

   This document proposes a YANG module for self-explanation data Node
   tag capability which augments system capabilities model and provide
   additional self-explanation data node attributes associated with node
   selectors within per-node capabilities.

Status of This Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at https://datatracker.ietf.org/drafts/current/.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   This Internet-Draft will expire on January 9, 2021.

Copyright Notice

   Copyright (c) 2020 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

Wu, et al.               Expires January 9, 2021                [Page 1]
Internet-Draft            Node Tags Capability                 July 2020

   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.

Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   2
     1.1.  Terminology . . . . . . . . . . . . . . . . . . . . . . .   3
   2.  Self-explanation data Node tag capability . . . . . . . . . .   3
     2.1.  Tree Diagram  . . . . . . . . . . . . . . . . . . . . . .   4
   3.  YANG Module . . . . . . . . . . . . . . . . . . . . . . . . .   5
   4.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .   8
     4.1.  Updates to the IETF XML Registry  . . . . . . . . . . . .   8
     4.2.  Updates to the YANG Module Names Registry . . . . . . . .   8
   5.  Security Considerations . . . . . . . . . . . . . . . . . . .   8
   6.  Contributors  . . . . . . . . . . . . . . . . . . . . . . . .   9
   7.  References  . . . . . . . . . . . . . . . . . . . . . . . . .   9
     7.1.  Normative References  . . . . . . . . . . . . . . . . . .  10
     7.2.  Informative References  . . . . . . . . . . . . . . . . .  11
   Appendix A.  Targeted data object subscription example  . . . . .  11
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .  14

1.  Introduction

   As described in [I-D.netconf-notification-capabilities], a server
   supporting YANG-Push MAY have a number of capabilities such as

   o  Supported (reporting) periods for periodic subscriptions;

   o  Maximum number of objects that can be sent in an update;

   o  Supported dampening periods for on-change subscriptions;

   o  The set of data nodes for which on-change notification is
      supported.

   Notification capability model defined in [I-D.netconf-notification-
   capabilities] allows a client to discover basic system capability and
   YANG-Push related capabilities both at implementation-time and run-
   time.  Without using this notification capability, it might lead to
   unexpected failures or additional message exchanges for NETCONF

Wu, et al.               Expires January 9, 2021                [Page 2]
Internet-Draft            Node Tags Capability                 July 2020

   clients to discover data objects with specific capability supported
   by a NETCONF server.

   When all telemetry data on the server subscribed by a particular
   subscriber is huge, it becomes more likely that a burst of streamed
Show full document text