Re: [netconf] Question about RFC8040 data root node and depth example

"Per Andersson (perander)" <perander@cisco.com> Thu, 07 May 2020 12:30 UTC

Return-Path: <perander@cisco.com>
X-Original-To: netconf@ietfa.amsl.com
Delivered-To: netconf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 609083A00E2 for <netconf@ietfa.amsl.com>; Thu, 7 May 2020 05:30:43 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -9.598
X-Spam-Level:
X-Spam-Status: No, score=-9.598 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001, USER_IN_DEF_DKIM_WL=-7.5] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=cisco.com header.b=XR0R9TwG; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=urBxpY2O
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 kQQsOO0C-hYY for <netconf@ietfa.amsl.com>; Thu, 7 May 2020 05:30:41 -0700 (PDT)
Received: from rcdn-iport-5.cisco.com (rcdn-iport-5.cisco.com [173.37.86.76]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A13733A00E0 for <netconf@ietf.org>; Thu, 7 May 2020 05:30:41 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=2636; q=dns/txt; s=iport; t=1588854641; x=1590064241; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-transfer-encoding:mime-version; bh=EHtLt2tUf8akn3rHfRuWzD4Amf9+cynXCJ3oKFOJaY4=; b=XR0R9TwGSLEOdFMUb411i24Hn3OuOCvNNBSAMB4RJKKKDkIqiNEI84vX ZPHgYAQ9cWp4GLYsh8rU4GQK5ZPyuSLLHwelLOhG6Jx6jHfQ5D9nEJEcQ Bc5qh30gGZ0A6ePZqIQVdHRHRE1CY5oFmt7yco/f+QbtRkF4tQEE0OKSe E=;
IronPort-PHdr: 9a23:DvRXNB+Mlr+oP/9uRHGN82YQeigqvan1NQcJ650hzqhDabmn44+7ZRCN6vBkjVuPVoLeuLpIiOvT5qbnX2FIoZOMq2sLf5EEURgZwd4XkAotDI/gawX7IffmYjZ8EJFEU1lorH6+OElRXs35Yg6arni79zVHHBL5OEJ8Lfj0HYiHicOx2qiy9pTfbh8OiiC6ZOZ5LQ69qkPascxFjA==
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: A0DKCQBV/rNe/51dJa1mH2qDG1EFgUYvKgqHXwONQIl5jjyCUgNUCwEBAQwBAS0CBAEBhEQCggckOBMCAwEBCwEBBQEBAQIBBQRthVYMhXIBAQECARIuAQE3AQQLAgEIDjghESUCBA4FCBqFUAMOIAGlTAKBOYhhdIE0gwABAQWFKg0Lgg4JgTiCY4lhGoFBP4FUgh8uPoEEgRqCGBgCg0OCLZkNmH5KCoJIk0yEZ50gHZwUkQICBAIEBQIOAQEFgWkigVZwFYMkUBgNlDSKVnQ3AgYIAQEDCXyQOgGBDwEB
X-IronPort-AV: E=Sophos;i="5.73,363,1583193600"; d="scan'208";a="509169487"
Received: from rcdn-core-6.cisco.com ([173.37.93.157]) by rcdn-iport-5.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 07 May 2020 12:30:39 +0000
Received: from XCH-ALN-001.cisco.com (xch-aln-001.cisco.com [173.36.7.11]) by rcdn-core-6.cisco.com (8.15.2/8.15.2) with ESMTPS id 047CUcZt025528 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=FAIL); Thu, 7 May 2020 12:30:39 GMT
Received: from xhs-rcd-003.cisco.com (173.37.227.248) by XCH-ALN-001.cisco.com (173.36.7.11) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Thu, 7 May 2020 07:30:38 -0500
Received: from xhs-aln-001.cisco.com (173.37.135.118) by xhs-rcd-003.cisco.com (173.37.227.248) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Thu, 7 May 2020 07:30:38 -0500
Received: from NAM12-MW2-obe.outbound.protection.outlook.com (173.37.151.57) by xhs-aln-001.cisco.com (173.37.135.118) with Microsoft SMTP Server (TLS) id 15.0.1497.2 via Frontend Transport; Thu, 7 May 2020 07:30:37 -0500
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=d8X5L5cTxPwVXGWAilzJE0qiYqZWK3qRGOBgq3IOLmQTqIx0BDm0rICqN1jALkm+7pXczbgYAd9fIZFMSkdoIdRoFfDo6/sl/mVVzBlKZNHozv1Wd9hBLNsn1NQsxUS/Oe3fgN8uZFcE0O/GWzIUsXC9GIntJOqyspnE828aDNx48j+RH8TxtdkHSNyuQWq/6XWUlDJX1duKu6Gl/zXI98JU9Na/HH0y07rqLzZVfW1QLHELfUzr6t6x5o1FgLx+GVtntL02MXK1waWpTw59PJl6hYBT8+TcKeOHKVV5+WFwHAiLS2hHt/cChz8D90BlUGMAa99nq4NG+kGMyH9vqQ==
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=eXG672Rddleg2mWmoGYxHbQzmHXXI00qKE0nmn2qZbk=; b=KOPh3Ryz22WZ4hTEkkNoqkxq9vk2Yll9mayKNyQXDzXPJGtUtb+3W4u2pasmU4gqC0Rs+USbEoOzPKej2Ht/XhvNpfihp6p/55Q9UITsM1jUPxhPPHi8mSynFGhu//vF3Zog6oTP+WrBOnPT7SMiTsoFxkuORbDQNxKB0rtrjleXfkcP15/4Q3pagsUETw0cZPEUFENXD5vjzLJtefd7v55a6DeKIvEkdklZl6zgvIKaeOHiq3jcnhtwtmUbp/2mO8KiVYPsMyXc9/tGPf9r1iYllMtaFVR56cQsdHrOGjXJplE/+IlkrkDhnYc6anCSPqBtI5ziOr0J69yrCOp6FA==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=cisco.com; dmarc=pass action=none header.from=cisco.com; dkim=pass header.d=cisco.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cisco.onmicrosoft.com; s=selector2-cisco-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=eXG672Rddleg2mWmoGYxHbQzmHXXI00qKE0nmn2qZbk=; b=urBxpY2OeSnIHj9waW168Bqno0swEF6dPPtirkDKY6I1M9kikX059tAxVftVdELJY+gfziM9YbLnfNsAGtCc7XdGQMW6bHyxx+J8GMUh0zbzYMoJKUQv6X+orajGZQ2xI0379wqA3L4IFRt90IIRqYw86kXa6RzzVLt2IeA8Pus=
Received: from DM6PR11MB3818.namprd11.prod.outlook.com (2603:10b6:5:145::22) by DM6PR11MB2874.namprd11.prod.outlook.com (2603:10b6:5:c9::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2979.28; Thu, 7 May 2020 12:30:36 +0000
Received: from DM6PR11MB3818.namprd11.prod.outlook.com ([fe80::597c:ff4:6845:c945]) by DM6PR11MB3818.namprd11.prod.outlook.com ([fe80::597c:ff4:6845:c945%3]) with mapi id 15.20.2979.028; Thu, 7 May 2020 12:30:36 +0000
From: "Per Andersson (perander)" <perander@cisco.com>
To: Henning Rogge <hrogge@gmail.com>
CC: "netconf@ietf.org" <netconf@ietf.org>
Thread-Topic: [netconf] Question about RFC8040 data root node and depth example
Thread-Index: AQHWJD+yoUO+XWZSK0KzI7OByDeRIaicW8t6gAAdHACAABAUqA==
Date: Thu, 07 May 2020 12:30:36 +0000
Message-ID: <DM6PR11MB38186C2A41E4D9AFE9240A3BDBA50@DM6PR11MB3818.namprd11.prod.outlook.com>
References: <CAGnRvuqk6UnbZSr0GzHRfS4E5ORGTmPO=cY_KA9gAg=Nout50A@mail.gmail.com> <DM6PR11MB38183AC997EA6C633F2A0864DBA50@DM6PR11MB3818.namprd11.prod.outlook.com>, <CAGnRvuox=3F0eH89a0FBHy3Bz9eSH=gKwh0zH6sFhcyM0kRVPw@mail.gmail.com>
In-Reply-To: <CAGnRvuox=3F0eH89a0FBHy3Bz9eSH=gKwh0zH6sFhcyM0kRVPw@mail.gmail.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
authentication-results: gmail.com; dkim=none (message not signed) header.d=none;gmail.com; dmarc=none action=none header.from=cisco.com;
x-originating-ip: [173.38.220.61]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: a6c22029-7092-4b23-9427-08d7f28271f1
x-ms-traffictypediagnostic: DM6PR11MB2874:
x-microsoft-antispam-prvs: <DM6PR11MB28749F60F3FF06F5828435B4DBA50@DM6PR11MB2874.namprd11.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:9508;
x-forefront-prvs: 03965EFC76
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: cuTEW8nhVT7ij5BMj8p1Xk7WBy5Qdh1yLuzAfGHE2SbyDBm5hzaZiQ9WTNnJgQGd9NKeWtoXeIjlH2G7ruo+h8V6rzv8kTCu20u59pbVM9kgKt3g4rkYEqM/JizdadD/DDdoEEELwlHlxmj3otgEjAIjOVv2VTHyeIf+q1qO3yM2SAolyRvgY1rF5lWkuQjspPenJynwuRTHm7F8EaMc099w/dhVRM+oI2e6M9OcAarkc9qwnENu2hWwsTQuSC1QBA1XbGxfBxoqXB56+JgcbxQj0oKTAh2AYDLL+saFeXe4sHoZjNyi+/6BFj45DAxYXrSi0ddp1BC7ZcfSQvX7fRoKnl7ASzNDr3hY9J+5DuScQfor8YwA0iHzeMIlH3c0Xu8eb+pWmXGRXsWU9kvWuz5eGPnCh5WJaoTydf55nOUXp69OxIOHU2RmKHiRnulWAPVw7aT8dmdIU3/Wv0SKkXVr0Z8OitBhPfK1o8sE2mV7tV0iRhi+5Gimgc9NHJlwYMZQvnhsI0HBg+SyoRNJrw==
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DM6PR11MB3818.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(4636009)(366004)(396003)(136003)(39860400002)(376002)(346002)(33430700001)(33440700001)(4326008)(9686003)(55016002)(478600001)(5660300002)(8936002)(83300400001)(2906002)(76116006)(83280400001)(83320400001)(83290400001)(83310400001)(316002)(91956017)(66446008)(66946007)(66556008)(64756008)(66476007)(6916009)(7696005)(8676002)(26005)(6506007)(86362001)(52536014)(71200400001)(33656002)(186003); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata: r0gVrLKgGCIGKfEIZwRuTc0H+ObTsxm8gk74U5qvQP7PKm/y1qNuzVQOIRrX3KkJOZk9Rx26dn+0mTKau+vvXfX+REpqqIucNbn1Ja9/DgZ3orh3sL14HNtlLZ73FOUuqc4p0jayoh74k+5Co8sKTCnqkuQs4YkTGTYLUTforNYLmVyS82pKLo9RAGPyyp5MRc7hMFkLAOXZpBs2RcpJo1qIO5hfw+sIOjyofp5WMk4L4ZnNBuVFIUzPbcefid3hg5OY+06lHZIBP3mX/th/lXXfCGVRKxGA52Iaqib+NYS0ee/aOOWX7PbmSwvh81dHZ5teHx5aFeBo9sUekZnxDiwx5cHBrfT9ZMNOmWNREzr++xLxzY//VXNKx0GSqw+N/Gh0LB3i2mR8NcVZp/EcEMhwApq2c7gIRJAPyFfbRnZLDtkLfUrE5t8o35vPXmOZMaM6Acp+pSHB3xi2Nql/FZoGy0rvfuMS1wP2//7a3FzJC3CExJK5dUdQ99BITg5UAdZj8NHm3VXcwLNMmueztT4jtFjA0mV4u/IMk49PurrUCwH7F5o1F9Vcmch49ea+oWydH5IZTGQyrwjYTdp0jvxhsZFYwMkDECEWel9U3NrtIOy45t/+bsQC7SUoxPRn/0crfS3MM+feuT9PxV4XFmXkiU0qnM+kX3qorwScJq0nvHExFRBjTCb67xUgphlY8LJy6jnI8zQHuT+EjBrNTPwCxiDHZ8/2QhoK4sdT6PTAohxto0rZl0GMGOXTtXvqdAaw4XHYC8M41P4PsAYfIqYkiveJ0gMVCh/3njqk1h8=
x-ms-exchange-transport-forked: True
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: a6c22029-7092-4b23-9427-08d7f28271f1
X-MS-Exchange-CrossTenant-originalarrivaltime: 07 May 2020 12:30:36.5023 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 5ae1af62-9505-4097-a69a-c1553ef7840e
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: cJBZyNKg0wFZxsAdkb59RoP40tsn7mAvHQR3bZA0vLn7lr2id/KUo/JCOnvg0bQM1eudiph2+sZjq+SBeMoWcQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR11MB2874
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.36.7.11, xch-aln-001.cisco.com
X-Outbound-Node: rcdn-core-6.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/mIIi2da2rRcbQ9LPNuHDhlK-tgw>
Subject: Re: [netconf] Question about RFC8040 data root node and depth example
X-BeenThere: netconf@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NETCONF WG list <netconf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netconf>, <mailto:netconf-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netconf/>
List-Post: <mailto:netconf@ietf.org>
List-Help: <mailto:netconf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netconf>, <mailto:netconf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 07 May 2020 12:30:44 -0000

> Henning Rogge <hrogge@gmail.com> on Thursday, May 7, 2020 13:14
>
>> Under the unified datastore (i.e. {+restconf}/data node), all top level
>> nodes would be found
>
> **sigh** I was worried to get this answer. My current implementation
> of the "yang data model" does load one library file... not a
> hierarchical series of libraries...
>
> This makes iterating over the "unified" datastore 'interesting',
> especially because of the depth/fields query parameter.
>
>> {
>>   "ietf-restconf:data": {
>>     "ietf-yang-library:yang-library": {},
>>     "example-jukebox:system": {},
>>     "example-jukebox:jukebox": {},
>>     "ietf-restconf-monitoring:restconf-state": {}
>> }
>
> In theory It should be possible to define the "data" YANG model and
> then import/augment everything from there, right?

The datastore resource "data" is not a model per say but a container
which should be populated with loaded models' top nodes.

Fom ietf-restconf.yang:

          container data {                                                                                         
            description                                                                                            
              "Container representing the datastore resource.                                                      
               Represents the conceptual root of all state data                                                    
               and configuration data supported by the server.                                                     
               The child nodes of this container can be any data                                                   
               resources that are defined as top-level data nodes                                                  
               from the YANG modules advertised by the server in                                                   
               the 'ietf-yang-library' module.";                                                                   
          }

See also RFC 8040 Section 3.4. Datastore Resource.


>> Note that example-jukebox have two top level nodes.
>
> I assume this is just your example, not the "example-jukebox" in the
> RFC 8040, right?

Yes, the example-jukebox.yang I referenced is probably from an earlier
RFC 8040 draft. But the principle is the same.


--
Per