[Netconf] RESTCONF depth parameter

"Upendra Rajput (uprajput)" <uprajput@cisco.com> Thu, 12 December 2013 22:19 UTC

Return-Path: <uprajput@cisco.com>
X-Original-To: netconf@ietfa.amsl.com
Delivered-To: netconf@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id ED71C1AE50E for <netconf@ietfa.amsl.com>; Thu, 12 Dec 2013 14:19:03 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -14.501
X-Spam-Level:
X-Spam-Status: No, score=-14.501 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, RCVD_IN_DNSWL_HI=-5, RP_MATCHES_RCVD=-0.001, SPF_PASS=-0.001, USER_IN_DEF_DKIM_WL=-7.5] autolearn=ham
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 yQJFbQJfNblB for <netconf@ietfa.amsl.com>; Thu, 12 Dec 2013 14:19:02 -0800 (PST)
Received: from rcdn-iport-5.cisco.com (rcdn-iport-5.cisco.com [173.37.86.76]) by ietfa.amsl.com (Postfix) with ESMTP id 72EE71AE176 for <netconf@ietf.org>; Thu, 12 Dec 2013 14:19:02 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=2757; q=dns/txt; s=iport; t=1386886736; x=1388096336; h=from:to:subject:date:message-id:mime-version; bh=bN4NxezAhTCfZ13JoQAInrelku5gvvivArr+iRl8BTI=; b=gUaai60nrzGR41NIBPBBfTQMw916fccIGCRfm1AfYxvAvqdiaohQXVjm 96nBBJXvDQmjXxt9iYkmm8qh3RoH2ayz11CYy1d1V3LHyYHAE/H//Cwdt nLec1A5bksY/jKoFHnfiS3pGYZm+5FtWEbUjUZG/BlilF2zZgZvmcex0m 4=;
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: AgMFAJE1qlKtJXG//2dsb2JhbABZgkZEgQ25dhZ0giyBCwEMAXMnBIgXo3+fJReTUASYFZIUgymCKg
X-IronPort-AV: E=Sophos; i="4.95,474,1384300800"; d="scan'208,217"; a="291211223"
Received: from rcdn-core2-4.cisco.com ([173.37.113.191]) by rcdn-iport-5.cisco.com with ESMTP; 12 Dec 2013 22:18:56 +0000
Received: from xhc-aln-x08.cisco.com (xhc-aln-x08.cisco.com [173.36.12.82]) by rcdn-core2-4.cisco.com (8.14.5/8.14.5) with ESMTP id rBCMIuqM009094 (version=TLSv1/SSLv3 cipher=AES128-SHA bits=128 verify=FAIL) for <netconf@ietf.org>; Thu, 12 Dec 2013 22:18:56 GMT
Received: from xmb-rcd-x12.cisco.com ([169.254.2.86]) by xhc-aln-x08.cisco.com ([173.36.12.82]) with mapi id 14.03.0123.003; Thu, 12 Dec 2013 16:18:56 -0600
From: "Upendra Rajput (uprajput)" <uprajput@cisco.com>
To: "netconf@ietf.org" <netconf@ietf.org>
Thread-Topic: RESTCONF depth parameter
Thread-Index: AQHO94glJ0RF/hpcY02i2VylCz74vg==
Date: Thu, 12 Dec 2013 22:18:55 +0000
Message-ID: <CECF7653.37003%uprajput@cisco.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
user-agent: Microsoft-MacOutlook/14.3.9.131030
x-originating-ip: [10.154.204.62]
Content-Type: multipart/alternative; boundary="_000_CECF765337003uprajputciscocom_"
MIME-Version: 1.0
X-Mailman-Approved-At: Fri, 13 Dec 2013 01:20:59 -0800
Subject: [Netconf] RESTCONF depth parameter
X-BeenThere: netconf@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: Network Configuration WG mailing list <netconf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netconf>, <mailto:netconf-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/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, 12 Dec 2013 22:22:43 -0000

Hi,

I was looking at the "depth" parameter example in RESTCONF draft version 2 in section 3.8.1. There they have an example that will retrieve 2 levels of configuration data nodes from "example-jukebox" module. And the result of retrieval is shown as:

      {
        "example-jukebox:jukebox" : {
          "library" : {
            "artist" : {
              "name" : "Foo Fighters"
            }
          },
          "player" : {
            "gap" : 0.5
          }
        }
      }

My question is since both containers and lists are defined as resources then why "list playlist" is not included in the result shown above ?

Will an error be returned when level is less then 1 ?

Also I will appreciate if you can provide sample of what will be returned when depth is 1 and 3.


Thanks
~Upendra