[netconf] [Errata Rejected] RFC8040 (6362)

RFC Errata System <rfc-editor@rfc-editor.org> Mon, 15 January 2024 14:27 UTC

To: muly_i@rad.com, andy@yumaworks.com, mbj@tail-f.com, kwatsen@juniper.net
From: RFC Errata System <rfc-editor@rfc-editor.org>
Cc: rwilton@cisco.com, iesg@ietf.org, netconf@ietf.org, rfc-editor@rfc-editor.org
Content-Type: text/plain; charset="UTF-8"
Message-Id: <20240115142735.DF0BF1A49952@rfcpa.amsl.com>
Date: Mon, 15 Jan 2024 06:27:35 -0800
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/49mpdXUa34xU_BLZgArcLpseiUo>
Subject: [netconf] [Errata Rejected] RFC8040 (6362)
Precedence: list

The following errata report has been rejected for RFC8040,
"RESTCONF Protocol".

--------------------------------------
You may review the report below and at:
https://www.rfc-editor.org/errata/eid6362

--------------------------------------
Status: Rejected
Type: Technical

Reported by: Muly Ilan <muly_i@rad.com>
Date Reported: 2020-12-22
Rejected by: Rob Wilton (IESG)

Section: 4.3.

Original Text
-------------
   The client might request the response header fields for an XML
   representation of a specific "album" resource:

      GET /restconf/data/example-jukebox:jukebox/\
         library/artist=Foo%20Fighters/album=Wasting%20Light HTTP/1.1
      Host: example.com
      Accept: application/yang-data+xml

   The server might respond as follows:

      HTTP/1.1 200 OK
      Date: Thu, 26 Jan 2017 20:56:30 GMT
      Server: example-server
      Content-Type: application/yang-data+xml
      Cache-Control: no-cache
      ETag: "a74eefc993a2b"
      Last-Modified: Thu, 26 Jan 2017 14:02:14 GMT

Corrected Text
--------------
   The client might request the response header fields for an XML
   representation of a specific "album" resource:

      GET /restconf/data/example-jukebox:jukebox/\
         library/artist=Foo%20Fighters/album=Wasting%20Light HTTP/1.1
      Host: example.com
      Accept: application/yang-data+xml

   The server might respond as follows:

      HTTP/1.1 200 OK
      Date: Thu, 26 Jan 2017 20:56:30 GMT
      Server: example-server
      Content-Type: application/yang-data+xml
      Cache-Control: no-cache


Notes
-----
Removed the "ETag" and "Last-Modified" header fields.

According to Appendix B.3.1. :
   To retrieve only the configuration child resources, the "content"
   parameter is set to "config".  Note that the "ETag" and
   "Last-Modified" headers are only returned if the "content" parameter
   value is "config".
 --VERIFIER NOTES-- 
This has been discussed at: https://mailarchive.ietf.org/arch/msg/netconf/SIpDoR7W8_na_USDHdMApjW6Wu8/

The example is not incorrect because an ETag and Last-Modified header are allowed to be returned if no content parameter has been specified, but only apply to the configuration data.

Note, the referenced text in Appendix B.3.1 (Note that the "ETag" and
"Last-Modified" headers are only returned if the "content" parameter
value is "config") looks to be incorrect and should be removed or clarified in a future revision of the protocol.

--------------------------------------
RFC8040 (draft-ietf-netconf-restconf-18)
--------------------------------------
Title               : RESTCONF Protocol
Publication Date    : January 2017
Author(s)           : A. Bierman, M. Bjorklund, K. Watsen
Category            : PROPOSED STANDARD
Source              : Network Configuration
Area                : Operations and Management
Stream              : IETF
Verifying Party     : IESG

[netconf] [Errata Rejected] RFC8040 (6362) RFC Errata System