Re: [netmod] [Netconf] New Version Notification for draft-lengyel-netmod-yang-instance-data-00.txt

Kent Watsen <> Mon, 12 February 2018 17:23 UTC

Return-Path: <>
Received: from localhost (localhost []) by (Postfix) with ESMTP id 9976A12D86B for <>; Mon, 12 Feb 2018 09:23:01 -0800 (PST)
X-Virus-Scanned: amavisd-new at
X-Spam-Flag: NO
X-Spam-Score: -0.711
X-Spam-Status: No, score=-0.711 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=0.001, HTTPS_HTTP_MISMATCH=1.989, RCVD_IN_DNSWL_LOW=-0.7, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: (amavisd-new); dkim=pass (2048-bit key)
Received: from ([]) by localhost ( []) (amavisd-new, port 10024) with ESMTP id 6W6HuofRD5UW for <>; Mon, 12 Feb 2018 09:22:58 -0800 (PST)
Received: from ( []) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by (Postfix) with ESMTPS id D618712D864 for <>; Mon, 12 Feb 2018 09:22:58 -0800 (PST)
Received: from pps.filterd ( []) by ( with SMTP id w1CHJ4be027228; Mon, 12 Feb 2018 09:22:56 -0800
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;; h=from : to : subject : date : message-id : content-type : mime-version; s=PPS1017; bh=5e7tZQgkN5RCGeexhjswxHLUTDTztBw8ymXmvEYx1tc=; b=ir6h99Sp6JtU/53EgRTUVbAz8d+2OKXqu/Ppw5FopjBzZ/ki8SqVT5SaJQU6ePTXEVHM wbDvDJsZIymQ0T9nSMS/yRHfAlhYNiuOyLBlNbv/8qGDVqODHWAtq1ZuVIhRpLpBTf06 uPt5xfK6g8CL9QqUKDdhGPVqM1jVVfu+MneBo4wECP3izKF/33CVtupBAPOidVdIH4Ip 8GuSZBOoSFKWNPcQBPcZTqz4LGVx9/AwkdH56Pmc6I/lYxpiZlstPa5IqLXKtDflqM09 tJNcqAC61AG09912ll6hUfVEuNVH6Wi0SEgEMnuWHogU2mab9HT5aFnq766Z6tMvu84c rA==
Received: from ( []) by with ESMTP id 2g39150p1b-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Mon, 12 Feb 2018 09:22:56 -0800
Received: from ( by ( with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.506.7; Mon, 12 Feb 2018 17:22:53 +0000
Received: from ([fe80::7433:3915:f20d:6747]) by ([fe80::7433:3915:f20d:6747%13]) with mapi id 15.20.0506.013; Mon, 12 Feb 2018 17:22:53 +0000
From: Kent Watsen <>
To: Balazs Lengyel <>, "" <>
Thread-Topic: [Netconf] [netmod] New Version Notification for draft-lengyel-netmod-yang-instance-data-00.txt
Thread-Index: AQHTpCYdVWSDEED4Lk27V9UCuItRvg==
Date: Mon, 12 Feb 2018 17:22:53 +0000
Message-ID: <>
Accept-Language: en-US
Content-Language: en-US
user-agent: Microsoft-MacOutlook/f.20.0.170309
x-originating-ip: []
x-ms-publictraffictype: Email
x-microsoft-exchange-diagnostics: 1; DM5PR05MB3676; 7:z355rEHfMEL/LmQpmCjWlYEjhckWiJMJKjHFs2u/9F32aDkhZbnEY5FcuP7EbmDtqMnIqdVPu4DIlSCpDH1543Q1C6U+Rv+V75iu+wMZiaUogFnzafZ681CIYMqhZOhfT0AE0u2fRBRGDrE0zT85PD9soiqk9gniIWhDx9LTtbaKI38SR2F/uEn2u21zMaHm5OcX9EWaIdPQuPl/m6OZBJLHOd2oC+1G7K3DeHd2wnVi1c0r5FBqP3wDbhxdyFV1
x-ms-exchange-antispam-srfa-diagnostics: SSOS;
x-ms-office365-filtering-ht: Tenant
x-ms-office365-filtering-correlation-id: 1d2d5b31-f644-4ee4-c2c6-08d5723d4030
x-microsoft-antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(48565401081)(5600026)(4604075)(3008032)(4534165)(4627221)(201703031133081)(201702281549075)(2017052603307)(7153060)(7193020); SRVR:DM5PR05MB3676;
x-ms-traffictypediagnostic: DM5PR05MB3676:
x-microsoft-antispam-prvs: <>
x-exchange-antispam-report-test: UriScan:(37575265505322)(28532068793085)(158342451672863)(10436049006162)(120809045254105)(138986009662008)(95692535739014)(21748063052155);
x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(6040501)(2401047)(5005006)(8121501046)(10201501046)(3231101)(944501161)(3002001)(93006095)(93001095)(6055026)(6041288)(20161123562045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123560045)(20161123558120)(20161123564045)(6072148)(201708071742011); SRVR:DM5PR05MB3676; BCL:0; PCL:0; RULEID:; SRVR:DM5PR05MB3676;
x-forefront-prvs: 0581B5AB35
x-forefront-antispam-report: SFV:NSPM; SFS:(10019020)(346002)(396003)(39380400002)(366004)(39860400002)(376002)(189003)(199004)(377424004)(252514010)(106356001)(6486002)(54896002)(6512007)(6436002)(82746002)(966005)(14454004)(53936002)(33656002)(236005)(6306002)(478600001)(6246003)(7736002)(86362001)(229853002)(8936002)(6116002)(3846002)(81166006)(2906002)(81156014)(3280700002)(105586002)(8676002)(36756003)(2501003)(59450400001)(53546011)(83716003)(99286004)(97736004)(83506002)(5250100002)(102836004)(6346003)(25786009)(316002)(68736007)(6506007)(58126008)(186003)(5660300001)(26005)(66066001)(15650500001)(606006)(3660700001)(110136005)(2420400007)(2900100001)(7110500001); DIR:OUT; SFP:1102; SCL:1; SRVR:DM5PR05MB3676;; FPR:; SPF:None; PTR:InfoNoRecords; MX:1; A:1; LANG:en;
received-spf: None ( does not designate permitted sender hosts)
x-microsoft-antispam-message-info: M0qk6A2qSxbl4D/F78j5q3B6ySFSWl/2HcgbOrSa7s9D1DftxMckw+pkG3x7U+EsMFPeZyMobS0PPu4uctHHjA==
spamdiagnosticoutput: 1:99
spamdiagnosticmetadata: NSPM
Content-Type: multipart/alternative; boundary="_000_A2DF7961BF614F36A0C1032A4BC5EAFCjunipernet_"
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: 1d2d5b31-f644-4ee4-c2c6-08d5723d4030
X-MS-Exchange-CrossTenant-originalarrivaltime: 12 Feb 2018 17:22:53.7989 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: bea78b3c-4cdb-4130-854a-1d193232e5f4
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR05MB3676
X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:, , definitions=2018-02-12_07:, , signatures=0
X-Proofpoint-Spam-Details: rule=outbound_spam_notspam policy=outbound_spam score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1711220000 definitions=main-1802120222
Archived-At: <>
Subject: Re: [netmod] [Netconf] New Version Notification for draft-lengyel-netmod-yang-instance-data-00.txt
X-Mailman-Version: 2.1.22
Precedence: list
List-Id: NETMOD WG list <>
List-Unsubscribe: <>, <>
List-Archive: <>
List-Post: <>
List-Help: <>
List-Subscribe: <>, <>
X-List-Received-Date: Mon, 12 Feb 2018 17:23:01 -0000

[removing netconf]

On 2/12/18, 12:20 PM, "Netconf on behalf of Kent Watsen" <<> on behalf of<>> wrote:

Hi Balazs,

I'm unclear about the scope of the problem.  Is it limited to server capabilities?    It seems that the idea is to move from having a stateful connection to a live server to having a way to pass the equivalent state even when not connected to the server.

Related, but probably not what you're angling for, I've been having issues with validating RESTCONF examples.  The issue is that the RESTCONF documents are context specific.  For instance, GET /widgets/ returns a document that might have an outermost element called "widgets", whereas GET /widgets/widget=foo returns a document that might have an outermost element called "widget".   In order to validate the second document, my code first wraps the "widget" element with a "widgets" element, and then the validation tools work.

Perhaps a more generalized instance data mechanism could include where in the tree the data is situated?   For example, it would be helpful if an action's instance data could provide more context (e.g., the input/output documents could indicate the name of the action, the object that the action was invoked on, etc.).

Generally, there is some state being held by the protocols that complicates examining instance data outside of the protocol, as extra bits of state need to be passed around separately.  It would be nice if the documents were (or at least could be) more self-contained.

Kent // contributor

On 2/8/18, 4:17 AM, "netmod on behalf of Balazs Lengyel" <<> on behalf of<>> wrote:


With Benoit I prepared a draft about how to document and use YANG defined instance data. It could be useful for documenting  server capabilities or preloading data defined in implementation time and probably for other purposes as well.

regards Balazs

-------- Forwarded Message --------

New Version Notification for draft-lengyel-netmod-yang-instance-data-00.txt


Wed, 7 Feb 2018 09:28:50 -0800



Benoit Claise <><>, Balazs Lengyel <><>

A new version of I-D, draft-lengyel-netmod-yang-instance-data-00.txt

has been successfully submitted by Balazs Lengyel and posted to the

IETF repository.

Name:          draft-lengyel-netmod-yang-instance-data

Revision:      00

Title:         YANG Instance Data Files and their use for Documenting Server Capabilities

Document date: 2018-02-06

Group:         Individual Submission

Pages:         10

URL:  <>





   This document specifies a standard file format for YANG instance

   data, that is data that could be stored in a datastore and whose

   syntax and semantics is defined by YANG models.  Instance data files

   can be used to provide information that is defined in design time.

   There is a need to document Server capabilities (which are often

   specified in design time), which should be done using instance data


Please note that it may take a couple of minutes from the time of submission

until the htmlized version and diff are available at

The IETF Secretariat


Balazs Lengyel                       Ericsson Hungary Ltd.

Senior Specialist

Mobile: +36-70-330-7909              email:<>