[netconf] [Errata Verified] RFC8040 (6473)

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

To: kyyun@cisco.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, iana@iana.org, rfc-editor@rfc-editor.org
Content-Type: text/plain; charset="UTF-8"
Message-Id: <20240115143117.99B761A49952@rfcpa.amsl.com>
Date: Mon, 15 Jan 2024 06:31:17 -0800
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/ZK3d1xVW7Px29N6ity8cVzskY8A>
Subject: [netconf] [Errata Verified] RFC8040 (6473)
Precedence: list

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

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

--------------------------------------
Status: Verified
Type: Technical

Reported by: Kyoung-Hwan Yun <kyyun@cisco.com>
Date Reported: 2021-03-10
Verified by: Rob Wilton (IESG)

Section: B.3.2

Original Text
-------------
   Example 3: depth=3

   To limit the depth level to the target resource plus two child
   resource layers, the value "3" is used.

      GET /restconf/data/example-jukebox:jukebox?depth=3 HTTP/1.1
      Host: example.com
      Accept: application/yang-data+json

   The server might respond as follows:

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

      {
        "example-jukebox:jukebox" : {
          "library" : {
            "artist" : {}
          },
          "playlist" : [
            {
              "name" : "Foo-One",
              "description" : "example playlist 1",
              "song" : {}
            }
          ],
          "player" : {
            "gap" : 0.5
          }
        }
      }

Corrected Text
--------------
   Example 3: depth=3

   To limit the depth level to the target resource plus two child
   resource layers, the value "3" is used.

      GET /restconf/data/example-jukebox:jukebox?depth=3 HTTP/1.1
      Host: example.com
      Accept: application/yang-data+json

   The server might respond as follows:

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

      {
        "example-jukebox:jukebox" : {
          "library" : {
            "artist" : []
          },
          "playlist" : [
            {
              "name" : "Foo-One",
              "description" : "example playlist 1",
              "song" : []
            }
          ],
          "player" : {
            "gap" : 0.5
          }
        }
      }

Notes
-----
"artist" and "song" are defined as list.  Therefore, according to RFC 7951, they should be encoded as array instead of object.

--------------------------------------
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 Verified] RFC8040 (6473) RFC Errata System