Re: [Netconf] {+restconf}/data

Andy Bierman <andy@yumaworks.com> Thu, 19 July 2018 20:58 UTC

Return-Path: <andy@yumaworks.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 C2085130F55 for <netconf@ietfa.amsl.com>; Thu, 19 Jul 2018 13:58:44 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.91
X-Spam-Level:
X-Spam-Status: No, score=-1.91 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, SPF_PASS=-0.001, T_DKIMWL_WL_MED=-0.01] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=yumaworks-com.20150623.gappssmtp.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 Zjrx_eupU2W0 for <netconf@ietfa.amsl.com>; Thu, 19 Jul 2018 13:58:41 -0700 (PDT)
Received: from mail-lf1-x136.google.com (mail-lf1-x136.google.com [IPv6:2a00:1450:4864:20::136]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id D2F42130E08 for <netconf@ietf.org>; Thu, 19 Jul 2018 13:58:40 -0700 (PDT)
Received: by mail-lf1-x136.google.com with SMTP id a134-v6so319128lfe.6 for <netconf@ietf.org>; Thu, 19 Jul 2018 13:58:40 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yumaworks-com.20150623.gappssmtp.com; s=20150623; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=rrt3O7kGuCFprbeGEZZjVJ8m7h7FnlbtWEPBPLLxXnA=; b=QluKQFEYafSTe3V6rGYZaj3RKHldcNt3bWSY49YjGSxbr8LwWxP1DNYDKHWsP7Dnfa T53OWlQnlVh+OJXcKODV8fnp8YliZ11bEOJIs5U24B463c1mF7VX4Ipy6l43qPXqYcCG 1cOCbHuB9e+tSgV/EtTpD39F5uCSBT+eNhykUepY8/0b/iWXvBMu9Lsv4MJX9FsS/2i8 AYH/D+NhTSSyNaFlTQh5Z8dy7TJfYYepAWHRIE+ooX0geze4YO0mQOiS2XkFasBzu374 apR+NzXyrMFHcyShlStB8oORkJTuOvH69f2OVwExvwezB3FYwUe4gHtxmdG05TjoViRy LWDw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=rrt3O7kGuCFprbeGEZZjVJ8m7h7FnlbtWEPBPLLxXnA=; b=Af/i1SKEWN0ONc9AXHus31lMP2pChEBHftbM9R44zZ4tC9LLY2e7QnmRzFMp/+leSh iaBwVENS4+qmspqF2Wb9IyC46Gj2i+exALHNx9DXLMlud1ZPjMbA4XSfzhn4g3lmXDBM JgnJTgCqHKJgas70bdLEPKQeh8rW7fmsKlWa/fwPYJjh8IM9tCZCi5qxjL1VJhzUjlDL i8YGQV8GwsggTDj0BxOM5a6zr2QcNsknlmzVNHMUYxUOo0C5SJ8B1S12wISGKGPPsrct GIWZA1kx4C73z3HCnod+X5fh1ao4eniht6DR3wfNIF2xoIcfEmrrqgsrEGbcbjLoNz6H CiZQ==
X-Gm-Message-State: AOUpUlGsChfIIH+r5eR3baCp8N4FfJEZ/9iFr5R62w4IYknLe9C/v8Tn Fv7vM7Lq5vQ5jezfzSCJEXs3Br3TP16FGGyjjSxOPg==
X-Google-Smtp-Source: AAOMgpdjHrLl4TROGf6K6riLG9bbfoWhigdVOOB/GmJrLZYZKihBUaMwgqsHP69d87BGoseWwDUZJJ0iEl82JOBvQxs=
X-Received: by 2002:a19:9b50:: with SMTP id d77-v6mr7355057lfe.108.1532033918936; Thu, 19 Jul 2018 13:58:38 -0700 (PDT)
MIME-Version: 1.0
Received: by 2002:a19:aa46:0:0:0:0:0 with HTTP; Thu, 19 Jul 2018 13:58:38 -0700 (PDT)
In-Reply-To: <87o9f39ccy.fsf@nic.cz>
References: <87efg0nxa1.fsf@nic.cz> <20180719084156.llzgfj465hov4s47@anna.jacobs.jacobs-university.de> <87o9f39ccy.fsf@nic.cz>
From: Andy Bierman <andy@yumaworks.com>
Date: Thu, 19 Jul 2018 13:58:38 -0700
Message-ID: <CABCOCHTa8R7xZzATFLJT56UiH3+U0ZcR2g7GBHWd_gNNYpM76Q@mail.gmail.com>
To: Ladislav Lhotka <lhotka@nic.cz>
Cc: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>, Netconf <netconf@ietf.org>
Content-Type: multipart/alternative; boundary="00000000000085bd3b05716071ff"
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/_4o68fDFuzQRz_aBGqqcfB0NXg8>
Subject: Re: [Netconf] {+restconf}/data
X-BeenThere: netconf@ietf.org
X-Mailman-Version: 2.1.27
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: <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, 19 Jul 2018 20:58:45 -0000

On Thu, Jul 19, 2018 at 1:53 PM, Ladislav Lhotka <lhotka@nic.cz> wrote:

> Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> writes:
>
> > Lada,
> >
> > there is no point in changing the definition of {+restconf}/data since
> > this would lead to interoperability issues and hence {+restconf}/data
> > remains what it is.
>
> Clients can have interoperability issues already now, e.g. if the server
> upgrades to the new "ietf-interfaces" module:
>
> - it can receive loads of unexpected state data and statistics
>
> - no data may be available under "interfaces-state" (because of the
>   ambiguity of the deprecated status).
>
> >
> > Yes, the new datastore names are longer but we did not want to require
> > globally unique datastore names (which would require some form of a
> > registry and that everybody uses the registry).
>
> Most of the text in RFC 8040 deals with the {+restconf}/data resource
> and its descendants, so effectively deprecating it in another document
> seems pretty confusing. I think that {+restconf}/data should remain the
> main entry point to configuration for an average client.
>
>
I agree with Juergen.
You cannot change the usage of /restconf/data.
Old clients will expect the old behavior and break if a new server did this.

There is no reason to deprecate or change this URI.
Pick a new URI for new functionality.
This is much less confusing and it does not break old clients.




> Lada
>
>
Andy


> >
> > /js
> >
> > On Wed, Jul 18, 2018 at 03:45:10PM -0400, Ladislav Lhotka wrote:
> >> Hi,
> >>
> >> it seems that using RESTCONF with the updated NMDA-compatible modules
> >> leads to the (IMO undesirable) result where under the "legacy" root
> >> "{+restconf}/data" state data are mixed with configuration. For example,
> >> with ietf-interfaces@2018-02-20
> >>
> >> GET {+restconf}/data/ietf-interfaces:interfaces
> >>
> >> yields configuration, state data and statistics, whereas with the old
> >> revision ietf-interfaces@2014-05-08 GET on the same URL yields only
> >> configuration. I think this defeats the purpose of NMDA.
> >>
> >> On the other hand, the short datastore-less URLs are too handy to be
> >> simply deprecated. I would therefore propose that {+restconf}/data be
> >> essentially an alias for the configuration datastore that the user can
> >> directly edit. This means:
> >>
> >> - with writable <running> it will be an alias to running
> >>
> >> - if the implementation uses <candidate>, it will be an alias to
> >>   <candidate>.
> >>
> >> Lada
> >>
> >> --
> >> Ladislav Lhotka
> >> Head, CZ.NIC Labs
> >> PGP Key ID: 0xB8F92B08A9F76C67
> >>
> >> _______________________________________________
> >> Netconf mailing list
> >> Netconf@ietf.org
> >> https://www.ietf.org/mailman/listinfo/netconf
> >
> > --
> > 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/>
>
> --
> Ladislav Lhotka
> Head, CZ.NIC Labs
> PGP Key ID: 0xB8F92B08A9F76C67
>
> _______________________________________________
> Netconf mailing list
> Netconf@ietf.org
> https://www.ietf.org/mailman/listinfo/netconf
>