[netmod] instance file format and etags/timestamps, xml attributes
Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> Wed, 28 November 2018 10:01 UTC
Return-Path: <j.schoenwaelder@jacobs-university.de>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 8E84C130E95 for <netmod@ietfa.amsl.com>; Wed, 28 Nov 2018 02:01:23 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_NONE=-0.0001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id ZwOet6YEY6gu for <netmod@ietfa.amsl.com>; Wed, 28 Nov 2018 02:01:20 -0800 (PST)
Received: from atlas5.jacobs-university.de (atlas5.jacobs-university.de [212.201.44.20]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A59FE128C65 for <netmod@ietf.org>; Wed, 28 Nov 2018 02:01:19 -0800 (PST)
Received: from localhost (demetrius5.irc-it.jacobs-university.de [10.70.0.222]) by atlas5.jacobs-university.de (Postfix) with ESMTP id 419E5E94 for <netmod@ietf.org>; Wed, 28 Nov 2018 11:01:18 +0100 (CET)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from atlas5.jacobs-university.de ([10.70.0.217]) by localhost (demetrius5.jacobs-university.de [10.70.0.222]) (amavisd-new, port 10032) with ESMTP id 47OEPsJ3fsUw for <netmod@ietf.org>; Wed, 28 Nov 2018 11:01:18 +0100 (CET)
Received: from hermes.jacobs-university.de (hermes.jacobs-university.de [212.201.44.23]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "hermes.jacobs-university.de", Issuer "Jacobs University CA - G01" (verified OK)) by atlas5.jacobs-university.de (Postfix) with ESMTPS for <netmod@ietf.org>; Wed, 28 Nov 2018 11:01:18 +0100 (CET)
Received: from localhost (demetrius4.jacobs-university.de [212.201.44.49]) by hermes.jacobs-university.de (Postfix) with ESMTP id 2C28920043 for <netmod@ietf.org>; Wed, 28 Nov 2018 11:01:18 +0100 (CET)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from hermes.jacobs-university.de ([212.201.44.23]) by localhost (demetrius4.jacobs-university.de [212.201.44.32]) (amavisd-new, port 10024) with ESMTP id dRmgFx05d5RD for <netmod@ietf.org>; Wed, 28 Nov 2018 11:01:17 +0100 (CET)
Received: from exchange.jacobs-university.de (SXCHMB01.jacobs.jacobs-university.de [10.70.0.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "exchange.jacobs-university.de", Issuer "DFN-Verein Global Issuing CA" (verified OK)) by hermes.jacobs-university.de (Postfix) with ESMTPS id B1ECD2003F for <netmod@ietf.org>; Wed, 28 Nov 2018 11:01:17 +0100 (CET)
Received: from anna.localdomain (10.50.218.117) by sxchmb03.jacobs.jacobs-university.de (10.70.0.155) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.1591.10; Wed, 28 Nov 2018 11:01:17 +0100
Received: by anna.localdomain (Postfix, from userid 501) id 12742300457450; Wed, 28 Nov 2018 11:01:16 +0100 (CET)
Date: Wed, 28 Nov 2018 11:01:16 +0100
From: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
To: netmod@ietf.org
Message-ID: <20181128100116.c6awxlwkxnm42gfb@anna.jacobs.jacobs-university.de>
Reply-To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
Mail-Followup-To: netmod@ietf.org
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
User-Agent: NeoMutt/20180716
X-ClientProxiedBy: SXCHMB03.jacobs.jacobs-university.de (10.70.0.155) To sxchmb03.jacobs.jacobs-university.de (10.70.0.155)
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/_geF-_GHalG44K8oz7SwYkd32aQ>
Subject: [netmod] instance file format and etags/timestamps, xml attributes
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 28 Nov 2018 10:01:24 -0000
draft-ietf-netmod-yang-instance-file-format-00.txt says: The JSON format SHALL follow the format of the reply returmed for a RESTCONF GET request directed at the datastore resource: {+restconf}/data. ETags and Timestamps SHOULD NOT be included, but if present SHOULD be ignored. I assume that you mean the JSON content in the message-body of the HTTP Response message for GET message. My understanding is that ETags and Timestamps (what are these precisely?) are carried in the HTTP header. So how could the ETag or 'Timestamps' be in the JSON data? We should not mess up the HTTP difference between header data and payload data. I also do not fully understand the text concerning the XML format. The XML format SHALL follow the format returned for a NETCONF GET operation. The <data> anydata (which is not part of the real data itself) SHALL contain all data that would be inside the <data> wrapper element of a reply to the <get> operation. XML attributes SHOULD NOT be present, however if a SW receiving a YANG Based Instance data file encounters XML attributes unknown to it, it MUST ignore them, allowing them to be used later for other purposes. It is unclear what exactly is the instance data - the entire reponse? Everything inside <data>? Everything inside and including <data>? I assume the second sentence is trying to say the later but I do not find it very clear not does it seem to be right. The examples show to content of the NETCONF <rpc-reply><data/></rpc-reply> inside a <data> container that belongs to the instance data format (two times <data> but in different namespaces). It is also unclear to me why XML attributes are to be removed. Why is that? If I snapshot <operational>, why should I remove important information such origin annotations? And removing attributes is actually plain wrong if you consider that attributes carry XML namespaces. /js PS: I am also concerned about the revision being not fine grained enough to be useful. I would love to have a much more precise timestamp telling me when the instance data was recorded. I would probably replace 'revision' with simply a 'timestamp' or add next to a 'revision' a more fine grained 'timestamp'. -- Juergen Schoenwaelder Jacobs University Bremen gGmbH Phone: +49 421 200 3587 Campus Ring 1 | 28759 Bremen | Germany Fax: +49 421 200 3103 <https://www.jacobs-university.de/>
- [netmod] instance file format and etags/timestamp… Juergen Schoenwaelder
- Re: [netmod] instance file format and etags/times… Juergen Schoenwaelder
- Re: [netmod] instance file format and etags/times… Balázs Lengyel
- [netmod] instance file format timestamp Balázs Lengyel