Re: [Netconf] RESTCONF modularilty

Kent Watsen <kwatsen@juniper.net> Fri, 22 August 2014 17:38 UTC

Return-Path: <kwatsen@juniper.net>
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 43FBE1A06C6 for <netconf@ietfa.amsl.com>; Fri, 22 Aug 2014 10:38:06 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.901
X-Spam-Level:
X-Spam-Status: No, score=-1.901 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001] 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 X0wrNqLdRX0k for <netconf@ietfa.amsl.com>; Fri, 22 Aug 2014 10:38:03 -0700 (PDT)
Received: from na01-bn1-obe.outbound.protection.outlook.com (mail-bn1blp0181.outbound.protection.outlook.com [207.46.163.181]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 5CF7C1A069E for <netconf@ietf.org>; Fri, 22 Aug 2014 10:38:03 -0700 (PDT)
Received: from CO1PR05MB458.namprd05.prod.outlook.com (10.141.72.140) by CO1PR05MB457.namprd05.prod.outlook.com (10.141.72.141) with Microsoft SMTP Server (TLS) id 15.0.1005.10; Fri, 22 Aug 2014 17:38:00 +0000
Received: from CO1PR05MB458.namprd05.prod.outlook.com ([169.254.10.154]) by CO1PR05MB458.namprd05.prod.outlook.com ([169.254.10.68]) with mapi id 15.00.1005.008; Fri, 22 Aug 2014 17:38:00 +0000
From: Kent Watsen <kwatsen@juniper.net>
To: Wojciech Dec <wdec.ietf@gmail.com>, Ladislav Lhotka <lhotka@nic.cz>
Thread-Topic: [Netconf] RESTCONF modularilty
Thread-Index: AQHPt+FqdMjKJfbxJUGUd4a2DR/a/pvbJ/OAgAAzbgCAAVFuAA==
Date: Fri, 22 Aug 2014 17:37:59 +0000
Message-ID: <D01CF760.7F32F%kwatsen@juniper.net>
References: <D01263B1.7E18B%kwatsen@juniper.net> <m2a96xly0s.fsf@nic.cz> <CAFFjW4hE5w2_a=wtKuYeuCfiL6uoF3B9Ug6qxY_ofc9DLUwyXA@mail.gmail.com>
In-Reply-To: <CAFFjW4hE5w2_a=wtKuYeuCfiL6uoF3B9Ug6qxY_ofc9DLUwyXA@mail.gmail.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
user-agent: Microsoft-MacOutlook/14.4.3.140616
x-originating-ip: [66.129.241.13]
x-microsoft-antispam: BCL:0;PCL:0;RULEID:;UriScan:;
x-forefront-prvs: 0311124FA9
x-forefront-antispam-report: SFV:NSPM; SFS:(164054003)(377454003)(199003)(189002)(51704005)(24454002)(4396001)(95666004)(81542001)(77982001)(20776003)(85852003)(105586002)(77096002)(107046002)(15975445006)(2656002)(19580395003)(106116001)(90102001)(99286002)(79102001)(101416001)(83506001)(19617315012)(80022001)(66066001)(76482001)(74502001)(50986999)(76176999)(31966008)(64706001)(86362001)(54356999)(81342001)(87936001)(46102001)(92726001)(99396002)(85306004)(83322001)(74662001)(21056001)(92566001)(575784001)(83072002)(16236675004)(15202345003)(106356001); DIR:OUT; SFP:; SCL:1; SRVR:CO1PR05MB457; H:CO1PR05MB458.namprd05.prod.outlook.com; FPR:; MLV:sfv; PTR:InfoNoRecords; A:1; MX:1; LANG:en;
Content-Type: multipart/alternative; boundary="_000_D01CF7607F32Fkwatsenjunipernet_"
MIME-Version: 1.0
X-OriginatorOrg: juniper.net
Archived-At: http://mailarchive.ietf.org/arch/msg/netconf/geTnMzzNtaOyZMDx-xnO5SXT5L0
Cc: NetConf <netconf@ietf.org>
Subject: Re: [Netconf] RESTCONF modularilty
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: Fri, 22 Aug 2014 17:38:06 -0000

I also agree XML/JSON should be on equal footing.   I like Andy's idea of having them both optional to implement.  I can easily imagine cases where an implementation only want to support a single encoding, perhaps one NETCONF supports in the future.


From: Wojciech Dec <wdec.ietf@gmail.com<mailto:wdec.ietf@gmail.com>>
Date: Thursday, August 21, 2014 at 1:30 PM
To: Ladislav Lhotka <lhotka@nic.cz<mailto:lhotka@nic.cz>>
Cc: Kent Watsen <kwatsen@juniper.net<mailto:kwatsen@juniper.net>>, NetConf <netconf@ietf.org<mailto:netconf@ietf.org>>
Subject: Re: [Netconf] RESTCONF modularilty




On 21 August 2014 16:26, Ladislav Lhotka <lhotka@nic.cz<mailto:lhotka@nic.cz>> wrote:
Hi,

Kent Watsen <kwatsen@juniper.net<mailto:kwatsen@juniper.net>> writes:

> The RESTCONF authors recently discussed adding support for filtering,
> sorting, and paging collections (i.e. lists).  One comment was that it
> was complex and better defined in another draft.  I agree, but more
> importantly, RESTCONF should be fully modular, providing an ability
> for implementations to selectively advertise support for various
> things.  This is exactly the approach we used for the NETCONF Light
> draft (http://tools.ietf.org/html/draft-schoenw-netconf-light-01), but
> RESTCONF being a new protocol, there is no reason to not do it from
> the get go.  This strategy was discussed in Toronto, but we felt we
> should take it to the list before restructuring the document...

I fully agree with this strategy. Support for individual capabilities
will be indicated somehow under the "restconf" resource?

...

>
> The corollary to RESTCONF might be:
>
>     Base Support
>           - the ability to GET and PUT on the top-level node using XML only
>
>     Optional Support:
>           - the ability to do PATCH  (this is already optional)
>           - the ability to use JSON encoding

I think XML and JSON should be given equal footing, i.e. the server
could support either or both. Perhaps the "Accept" header on the client
side and 406/415 status codes on the server side could be enough?

+1 re XML and JSON on equal footing.

Lada

>           - the ability to POST/GET/PUT/DELETE subtrees   (PATCH too, is support for it is advertised)
>           - the ability to use "select" with GET operations
>           - the ability to use "filter" with GET on collection resources (i.e. lists) and event streams
>           - the ability to do pagination with GET on collection resources (i.e. lists)
>           - the ability to do sorting with GET on collection resources (i.e. lists)
>
>
> Thoughts?
>
> Thanks,
> Kent
>
>
>
> _______________________________________________
> Netconf mailing list
> Netconf@ietf.org<mailto:Netconf@ietf.org>
> https://www.ietf.org/mailman/listinfo/netconf

--
Ladislav Lhotka, CZ.NIC Labs
PGP Key ID: E74E8C0C

_______________________________________________
Netconf mailing list
Netconf@ietf.org<mailto:Netconf@ietf.org>
https://www.ietf.org/mailman/listinfo/netconf