[netmod] Instance-data-format - shall we define etag and last-modified annotation ?

Balázs Lengyel <balazs.lengyel@ericsson.com> Mon, 22 July 2019 19:24 UTC

Return-Path: <balazs.lengyel@ericsson.com>
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 09A4812011B for <netmod@ietfa.amsl.com>; Mon, 22 Jul 2019 12:24:06 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2
X-Spam-Level:
X-Spam-Status: No, score=-2 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=ericsson.com
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 C6ewulNCaaHz for <netmod@ietfa.amsl.com>; Mon, 22 Jul 2019 12:24:02 -0700 (PDT)
Received: from EUR01-HE1-obe.outbound.protection.outlook.com (mail-he1eur01on062b.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe1e::62b]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 382AA12004E for <netmod@ietf.org>; Mon, 22 Jul 2019 12:24:02 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=NT5A+VZWP2oBtE9fS2GN4O0Mb4VSapyJza1vkUZU2tZAbNlX+CdVYLlH/hAB9H2k3M2CT3MNiUJfoO3A8UtLzZfP7iKhR2RKeOaSCLTKn1LhFH+ST6y+2ToS/FkGuYoSiIWrSPtO0z3ieVokCNW2UWKzESfFfXVhHUFfhv6UJZ0+PAkcldEFrNn6m5/6trmKxaZd8kCjB0wHCXz0Z5G40fJmlejG0ZKgft0b0EoOd1Z5aHd2GixGHr8JhlGwY9Z7W5cuUgAfjBWN73/qUMHNtvahiPDxStfkNY7Bn7Whq7XIK+S5nRPMG18qWwDTTxNgZr3N3q6DrpziT5irBIPzhQ==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=+MpgMGGbCv3IcZOzp17c3JRO8lZH07wJezKVbm3I1CU=; b=fMa5e1+J6zAgPKLsauKGPwPOGuTPGo8MvEF4YJMap76oBMpvG+xTasMl5tMkeGP/GzkZQL9su0tm5gXD+D6Ypgjkd5fEJyTDX3yH7t8XOnr9WhDNCy/Gjzrglajb/0X28ndjM+ON/vg+rRMMwT/9Dtppr3eDajDSgI3lA+BakSwfbNJNK4DhC4LkagoZnR1FDbu5KIjN/4bsdct1yM5gw9mXCndm/Ukeebj6LcYI3SyB30qCvMYIzQ6KEC0YYxFinVg/6y6C9OuY+16OGqoDh1DiGWpF2gvFGhWlkMGQ/kC9jz/7BIZZzLwt0AQbWo0BFkI19XI3qQnjYdEiUe1c3w==
ARC-Authentication-Results: i=1; mx.microsoft.com 1;spf=pass smtp.mailfrom=ericsson.com;dmarc=pass action=none header.from=ericsson.com;dkim=pass header.d=ericsson.com;arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ericsson.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=+MpgMGGbCv3IcZOzp17c3JRO8lZH07wJezKVbm3I1CU=; b=XPJisO0iCkqSxDWOGysS6FAPz9pvXojkV5PTs3tbpWbftO60tgCg1DKOKpAkHarDA/m3wR8tWNoADYkVeAO5PyaPCeskjZLge31R/aP48lmoQMuyD0Xckq7WfIEdqR9SGAK06uqbB5mcLbQ37pzxZU6qc/M/AGxFSxd1+BZJqgo=
Received: from VI1PR0701MB2286.eurprd07.prod.outlook.com (10.169.137.153) by VI1PR0701MB2527.eurprd07.prod.outlook.com (10.168.139.140) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2115.9; Mon, 22 Jul 2019 19:23:59 +0000
Received: from VI1PR0701MB2286.eurprd07.prod.outlook.com ([fe80::5556:4c20:cd8d:686a]) by VI1PR0701MB2286.eurprd07.prod.outlook.com ([fe80::5556:4c20:cd8d:686a%11]) with mapi id 15.20.2115.005; Mon, 22 Jul 2019 19:23:59 +0000
From: =?iso-8859-1?Q?Bal=E1zs_Lengyel?= <balazs.lengyel@ericsson.com>
To: "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: Instance-data-format - shall we define etag and last-modified annotation ?
Thread-Index: AdVAwv3YCGqZ1KMoT7S8jMt8r0MeZg==
Date: Mon, 22 Jul 2019 19:23:59 +0000
Message-ID: <VI1PR0701MB2286D806027F541651B0BCE6F0C40@VI1PR0701MB2286.eurprd07.prod.outlook.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: yes
X-MS-TNEF-Correlator:
authentication-results: spf=none (sender IP is ) smtp.mailfrom=balazs.lengyel@ericsson.com;
x-originating-ip: [2001:67c:1232:144:1816:c5a7:7b6a:280f]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 76c37d96-0eda-4d13-4855-08d70eda25b0
x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600148)(711020)(4605104)(1401327)(2017052603328)(49563074)(7193020); SRVR:VI1PR0701MB2527;
x-ms-traffictypediagnostic: VI1PR0701MB2527:
x-microsoft-antispam-prvs: <VI1PR0701MB2527739DB9EABA09AA4BBC7EF0C40@VI1PR0701MB2527.eurprd07.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:10000;
x-forefront-prvs: 01068D0A20
x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(4636009)(366004)(39860400002)(376002)(396003)(136003)(346002)(189003)(199004)(25786009)(2906002)(81156014)(256004)(81166006)(6116002)(14444005)(790700001)(316002)(9326002)(74316002)(1730700003)(53936002)(2351001)(7736002)(99936001)(8936002)(5660300002)(52536014)(14454004)(8676002)(186003)(2501003)(476003)(66446008)(6916009)(45776006)(64756008)(66556008)(66476007)(66616009)(7696005)(66946007)(76116006)(46003)(33656002)(486006)(236005)(54896002)(86362001)(71200400001)(71190400001)(102836004)(55016002)(9686003)(99286004)(606006)(6306002)(6506007)(6436002)(5640700003)(478600001)(68736007); DIR:OUT; SFP:1101; SCL:1; SRVR:VI1PR0701MB2527; H:VI1PR0701MB2286.eurprd07.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1;
received-spf: None (protection.outlook.com: ericsson.com does not designate permitted sender hosts)
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam-message-info: d+xtp+J/iTNzQhuNKQosA614o6mc023N+OJfyXyoQ0m6XyT7QO0gi+OrSoM9qCSOYlWrNTDCX/AA66ID6WuJUUumO2Ti9aNjgBUtod8pvHuQ3P212sPAX+iELe6fL53LgWvnTYOF9x4fAqtcJxQe1IhpodiHS+UVIKPXlayRzpnbtGu7yweultpIgf9p3UIV8wJpV13QYYVIwpQihRCpuY9j9+u78C4IbLu5ltB3ReXwslOfFERk0WCewPeQZUsqbKu38VsJ3p/Uc6CmmL9rZkHfOXg67R95fXblZNlSFDxnKp5je5ivcIdr3Cbig4V5/rsijA02hzBJcp1wLvzFIAJU+vgWSLJt4prMwHUU12BKfWTC2B9z2L5u58up1vkVgDSiR/gdoMCrbr4s10hZFGCUiTmyImB+yJD16spKtfg=
Content-Type: multipart/signed; protocol="application/x-pkcs7-signature"; micalg=SHA1; boundary="----=_NextPart_000_027A_01D540A1.7A696EE0"
MIME-Version: 1.0
X-OriginatorOrg: ericsson.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 76c37d96-0eda-4d13-4855-08d70eda25b0
X-MS-Exchange-CrossTenant-originalarrivaltime: 22 Jul 2019 19:23:59.3184 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 92e84ceb-fbfd-47ab-be52-080c6b87953f
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: balazs.lengyel@ericsson.com
X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR0701MB2527
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/4dxi5IfyzjKkvMH802P_FVpwehg>
Subject: [netmod] Instance-data-format - shall we define etag and last-modified annotation ?
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: Mon, 22 Jul 2019 19:24:06 -0000

Hello,

Restconf (rfc8040) defined to useful bits of metadata about a YANG defined
datastore: entity-tag and the last-modified timestamp.

These can be very useful in instance data sets, however Restconf defines an
encoding for these (as part of the http headers) that can not be used in
instance-data-sets.

draft-ietf-netmod-yang-instance-file-format-03#section-7.2
<https://tools.ietf.org/html/draft-ietf-netmod-yang-instance-file-format-03#
section-7.2>     defines metadata annotations for these two, that can be
used in instance data

  md:annotation entity-tag {
      type string;
      description "Used to encode the entity-tag …";
    }
    md:annotation last-modified {
      type yang:date-and-time;
      description "Contains the date and time when the annotated
        instance was last modified (or created).";
    }

In order to be able to include this data, the annotations need to be defined
in some YANG module.

 

The question has been raised whether 

1.	these annotations should be defined in the ietf-yang-instance-data
module as it needs them, as that is open or
2.	the annotations should be defined in another draft in a separate
YANG module as any other annotation

The first option is better because the instance-data needs these
annotations, and at this point we see no other user for the annotation, and
in this case the ongoing instance data draft will define it

The second option is better because, if later there are other users for
these annotations, it might be strange to reference the
ietf-yang-instance-data module. Also why provide special treatment to these
2 annotations?

 

The authors support option 1 and don’t have the time to start a new draft to
define these annotations.

On IETF105 in the room there was more support for option 1. 

 

Please indicate if you have an opinion about the choice of 1 or 2

 

Regards Balazs