Re: [netconf] RESTCONF PUT method on list URI/Resources

Kent Watsen <kent+ietf@watsen.net> Sat, 06 June 2020 19:03 UTC

Return-Path: <010001728b042c6f-26b300e2-e7d9-47c3-9963-8603b17f9b2e-000000@amazonses.watsen.net>
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 137C23A0A6E for <netconf@ietfa.amsl.com>; Sat, 6 Jun 2020 12:03:29 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.897
X-Spam-Level:
X-Spam-Status: No, score=-1.897 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_NONE=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=amazonses.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 sXVWgLd5a-PN for <netconf@ietfa.amsl.com>; Sat, 6 Jun 2020 12:03:27 -0700 (PDT)
Received: from a8-88.smtp-out.amazonses.com (a8-88.smtp-out.amazonses.com [54.240.8.88]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 750403A0A52 for <netconf@ietf.org>; Sat, 6 Jun 2020 12:03:27 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=224i4yxa5dv7c2xz3womw6peuasteono; d=amazonses.com; t=1591470206; h=From:Message-Id:Content-Type:Mime-Version:Subject:Date:In-Reply-To:Cc:To:References:Feedback-ID; bh=DOWWSwqxCxESEGBTretsaRVcn2oOpYuyIrXCFju/HZA=; b=HfaoVFvcmOzr49bpona6OtOgNZcVqcgjO3d3i3xnjU3WRrHu+i9gDCDQS0yPatcE peZ5hL1J0VnUmGs1ejoXh2lA/CAwQ2ljVdvlTyfDCEG+pOteMi6Z4QHjSVu+LeswpBV uzJdazNY+Yw4CGchNXIxGTTbk2UqTYtOf1G7zn4w=
From: Kent Watsen <kent+ietf@watsen.net>
Message-ID: <010001728b042c6f-26b300e2-e7d9-47c3-9963-8603b17f9b2e-000000@email.amazonses.com>
Content-Type: multipart/alternative; boundary="Apple-Mail=_AE44527C-B7A8-4D99-9A58-B5E70F2C28A7"
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.80.23.2.2\))
Date: Sat, 06 Jun 2020 19:03:26 +0000
In-Reply-To: <0E0AE22C-4A71-48B9-9DF4-E716884FE130@sedonasys.com>
Cc: "netconf@ietf.org" <netconf@ietf.org>
To: Anton Snitser <antons@sedonasys.com>
References: <0E0AE22C-4A71-48B9-9DF4-E716884FE130@sedonasys.com>
X-Mailer: Apple Mail (2.3608.80.23.2.2)
X-SES-Outgoing: 2020.06.06-54.240.8.88
Feedback-ID: 1.us-east-1.DKmIRZFhhsBhtmFMNikgwZUWVrODEw9qVcPhqJEI2DA=:AmazonSES
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/-tSTCFv8_JtAGtOmI95qWe2CFss>
Subject: Re: [netconf] RESTCONF PUT method on list URI/Resources
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: Sat, 06 Jun 2020 19:03:29 -0000


Hi Anton,

> On Jun 4, 2020, at 12:00 PM, Anton Snitser <antons@sedonasys.com> wrote:
> 
> Hello everyone,
>  
> I am inquiring about the validity of the PUT method on a list resource

Currently, a list is not itself a data resource.  It’s tempting, I know, but it’s per RFC 8040...


> As per RFC 8040
>  
> List entries are data resources but not list themselves – not sure as not explicitly mentioned.
> <image001.png>
> PUT is used to create/replace the target “data resource”
> <image002.png>
>  
> So would it be a valid implementation to allow PUT method on a list resource? /restconf/data/module:top-level-cont/list

No, that would be invalid API.


> Also, generally speaking is it fair to assume if not explicitly denied/mandated it is up to the implementation?

RFCs intend to be fully-specified, so as to ensure interoperability.   If you find something unclear, it is best to ping the list here; not only will you get clarification, but we may find the need to file an errata if warranted.

K.

>  
> Thanks,
> Best regards
>  
>  
> <image003.png>
> Anton Snizar | Systems Engineer
> 
> m: +972-504042744
> e: antons@sedonasys.com <mailto:antons@sedonasys.com>
> w: sedonasys.com <https://sedonasys.com/>
> l: Linkedin <http://linkedin.com/in/anton-snizar-4aa57646/>
>  
> _______________________________________________
> netconf mailing list
> netconf@ietf.org <mailto:netconf@ietf.org>
> https://www.ietf.org/mailman/listinfo/netconf <https://www.ietf.org/mailman/listinfo/netconf>