[Ietf-message-headers] Updates to registration request for EntityId, Isolation, OData-MaxVersion, and OData-Version

[Chet Ensign <[e-mail]>]

This message contains an update to the registration request submitted on
August 29 2018 in
https://www.ietf.org/mail-archive/web/ietf-message-headers/current/msg00195.html

In response to this request, on August 29, in
https://www.ietf.org/mail-archive/web/ietf-message-headers/current/msg00196.html,
Ted Hardie wrote:

---

I'm a little confused on one point.  The Isolation header states that it
was called OData-Isolation in version 4.0, but the linked ABNF document
says:

isolation  = [ "OData-" ] "Isolation" ":" OWS "snapshot"

That seems to indicate that both ODate-Isolation and Isolation are expected
to be valid for this token.  The ABNF for EntityID is similar:

entityid   = [ "OData-" ] "EntityID" ":" OWS IRI-in-header

Can you clarify the intent here?  Are both expressions of this token
expected to continue?

In general, "Isolation" seems to be a very general concept, and the
reservation of it, unadorned, for a single token use ("snapshot") is
somewhat surprising compared to the more-obviously scoped OData-isolation.
EntityID seems similar board in possible usage outside the OData
specification.

---

In response, the TC renamed EntityId header to OData-EntityId and added
additional values for the Isolation header to align with most database
systems.


On August 30, in
https://www.ietf.org/mail-archive/web/ietf-message-headers/current/msg00197.html,
Mark Nottingham wrote:

---

"Applicable protocol" should be "http", I think.

---

In response, the TC changed the Applicable protocol to http.

Below, please find the revised request. I have included the prior values in
[ ]s so that all the changes are visible.

Please let us know if this addresses your comments and if you have any
other questions or concerns.

---

Open Data (OData) Protocol IANA Header registration request
28-Nov-2018

This documentation contains the information needed for Permanent
Registration of the OData specific request headers with IANA as called out
in RFC 3864 - Registration Procedures for Message Header Fields.

The OData headers to be registered as Permanent Headers are

OData-EntityId  [WAS EntityID]
Isolation
OData-MaxVersion
OData-Version

The details as required by RFC 3864 for these headers are listed below

####
Header field name:
OData-EntityId  [WAS EntityID]

Applicable protocol:
http   [WAS OASIS Open Data Protocol (OData)]

Status:
Standard

Author/Change controller:
OASIS

Specification document(s):
OData Version 4.01 Part 1: Protocol -
http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_HeaderEntityIdODataEntityId


Related information:
    None  [WAS The EntityId header was named OData-EntityId in OData
version 4.0.]


####
Header field name:
Isolation

Applicable protocol:
http   [WAS OASIS Open Data Protocol (OData)]

Status:
Standard

Author/Change controller:
OASIS

Specification document(s):
OData Version 4.01 Part 1: Protocol -
http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_HeaderIsolationODataIsolation

Related information:
The Isolation header was named OData-Isolation in OData version 4.0.  The
OData Protocol document referenced above defines one valid value,
snapshot.  To make this header useful to applications other than OData this
registration also defines the values read-uncommitted, read-committed,
repeatable-read and serializable.  These correspond to the standard
transaction isolation levels exposed by most database systems.
   [WAS The Isolation header was named OData-Isolation in OData version
4.0.]


####
Header field name:
OData-MaxVersion

Applicable protocol:
http   [WAS OASIS Open Data Protocol (OData)]

Status:
Standard

Author/Change controller:
OASIS

Specification document(s):
OData Version 4.01 Part 1: Protocol -
http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_HeaderODataMaxVersion



Related information:
<none>



####
Header field name:
OData-Version

Applicable protocol:
http   [WAS OASIS Open Data Protocol (OData)]

Status:
Standard

Author/Change controller:
OASIS

Specification document(s):
OData Version 4.01 Part 1: Protocol -
http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_HeaderODataVersion



Related information:
<none>



-- 

/chet
----------------
Chet Ensign
Chief Technical Community Steward
OASIS: Advancing open standards for the information society
http://www.oasis-open.org

Primary: [phone]
Mobile: [phone]