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

Mark Nottingham <mnot@mnot.net> Fri, 07 December 2018 00:58 UTC

Return-Path: <mnot@mnot.net>
X-Original-To: ietf-message-headers@ietfa.amsl.com
Delivered-To: ietf-message-headers@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 36AAF12D4E8 for <ietf-message-headers@ietfa.amsl.com>; Thu, 6 Dec 2018 16:58:03 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.701
X-Spam-Level:
X-Spam-Status: No, score=-2.701 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=mnot.net header.b=vvL/vHq2; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=mmG9ZTkm
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 FmnX3lin0cfR for <ietf-message-headers@ietfa.amsl.com>; Thu, 6 Dec 2018 16:57:57 -0800 (PST)
Received: from out1-smtp.messagingengine.com (out1-smtp.messagingengine.com [66.111.4.25]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id B4943124BE5 for <ietf-message-headers@ietf.org>; Thu, 6 Dec 2018 16:57:57 -0800 (PST)
Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.nyi.internal (Postfix) with ESMTP id AA2AA21614; Thu, 6 Dec 2018 19:57:56 -0500 (EST)
Received: from mailfrontend1 ([10.202.2.162]) by compute3.internal (MEProxy); Thu, 06 Dec 2018 19:57:56 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mnot.net; h= content-type:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; s=fm1; bh=u U8HFpwlVw+eaMBGAzvGALbkBQ038p8DsEDJDdoymmM=; b=vvL/vHq2/7ZhJHc7n dVlxW2J1rxd08atw+44pRuX7EJqHjxQ+N6QKm35Caz2OTe7+wZLFe/POCm+0p0Yq ZWyiyAp4XXCYLFgS9k2g6Z9tE09vJKLXeMXCeY1X4F7yCNjR8QWl6ZVbDXGH7+D4 /4BwL1PV/8s/2zYyI0ZT0wQHqTHl9Rc0m9RSwCDazTZonbCt3TZWCUUKrJPzMIIA E539qOP1dEBI519/f/1hlOqyBLi7grm6oaXKhpKKSRFZgLzICEgn5XroF2LTlYRI woTFlawz2xkl3XWptqugXm9N/ym15BAz97SMC06N2mV/eCIiYaVPTx72egixMper zBQXQ==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm1; bh=uU8HFpwlVw+eaMBGAzvGALbkBQ038p8DsEDJDdoym mM=; b=mmG9ZTkmf5X3/Dvk9U9oM/LSC32C8huvP21BW5hQh2izsudRv5kNP6kK6 jZoMbzT3iyPHfV64mah5kvJDnefQJeTyXSMGHNOiFrfEWn1gHYgd3zF6Zw/VIz/X 7s1t4T49kuPWpTLxaIaLjCwU6xCyLK7sf8Uhp4YOCq6B/NIFNjwS/d/eGqvpuAWp bgm6bzcBOSp6EJrJPCSiL065zi8UV5V+0Xar1WG4oZlDlfAcL3Obni3APo+Xarh8 4KHPWvkXsSNZPhifB6I/RA4ivO7vYfwDadNKgd8HvpukNEsVtHDNjNKxELJTc7TM 8ab+Scb2tms8e+9zyq/UYNJvEDXFw==
X-ME-Sender: <xms:k8UJXM2xpLLLNiPgrhzsiIUS2ias-Pr_d-urAsTxXhJiKNBCOKeZLg>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedtkedrudefkedgvdelucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfquhhtnecuuegrihhlohhuthemucef tddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenucfjughrpegtggfuhfgjff fgkfhfvffosehtqhhmtdhhtddvnecuhfhrohhmpeforghrkhcupfhothhtihhnghhhrghm uceomhhnohhtsehmnhhothdrnhgvtheqnecuffhomhgrihhnpehorghsihhsqdhophgvnh drohhrghdpihgvthhfrdhorhhgpdhmnhhothdrnhgvthdphhhtthhpihhthhhinhhkrddq qddqihhnnecukfhppedugeegrddufeeirddujeehrddvkeenucfrrghrrghmpehmrghilh hfrhhomhepmhhnohhtsehmnhhothdrnhgvthenucevlhhushhtvghrufhiiigvpedt
X-ME-Proxy: <xmx:k8UJXIeBGUx4iY-eA0FOwfEiCfotVopOEyelwwrg5-WTdrQ5gstlPw> <xmx:k8UJXA9bD4lD_99uJGn-b1DyMzaIsT4T_GQxjaTE1D18tExgECpXqg> <xmx:k8UJXBo03wB7WJGZlmfhSOEbL71glPPTFEQ_wziHC8moNj8ITAmpEA> <xmx:k8UJXOywTOJm2Nw9_pCcWkHGzY-ILGLc2NRFBix7cLuQYT0r1QSL3g> <xmx:k8UJXDl3tS1MvxGe88D9tgxC6zrsMP36SlIH2OIpj0hAkHdBxe1aDg> <xmx:lMUJXJPWG749PXi3g262vZ59QKVgcK2UJGYJB0-71AFferVFGsUDUQ>
Received: from attitudadjuster.mnot.net (unknown [144.136.175.28]) by mail.messagingengine.com (Postfix) with ESMTPA id 1EF7EE4430; Thu, 6 Dec 2018 19:57:52 -0500 (EST)
Content-Type: text/plain; charset=us-ascii
Mime-Version: 1.0 (Mac OS X Mail 12.0 \(3445.100.39\))
From: Mark Nottingham <mnot@mnot.net>
In-Reply-To: <CAAwgnnPNNUWDPQvo5bUzpd7FQ+sSaZYNydCBPTfVV6QY5TZhEw@mail.gmail.com>
Date: Fri, 7 Dec 2018 11:57:33 +1100
Cc: ietf-message-headers@ietf.org, "Ralf Handl (SAP)" <ralf.handl@sap.com>
Content-Transfer-Encoding: quoted-printable
Message-Id: <724DB0C1-B093-46C6-B55B-A5DDE9ECACE1@mnot.net>
References: <CAAwgnnPNNUWDPQvo5bUzpd7FQ+sSaZYNydCBPTfVV6QY5TZhEw@mail.gmail.com>
To: Chet Ensign <chet.ensign@oasis-open.org>
X-Mailer: Apple Mail (2.3445.100.39)
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf-message-headers/BjWM3pDhJDzyEg9Fn0Ahp3cXiEY>
Subject: Re: [Ietf-message-headers] Updates to registration request for EntityId, Isolation, OData-MaxVersion, and OData-Version
X-BeenThere: ietf-message-headers@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Discussion list for header fields used in Internet messaging applications." <ietf-message-headers.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf-message-headers>, <mailto:ietf-message-headers-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ietf-message-headers/>
List-Post: <mailto:ietf-message-headers@ietf.org>
List-Help: <mailto:ietf-message-headers-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf-message-headers>, <mailto:ietf-message-headers-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 07 Dec 2018 00:58:03 -0000

Chet,

Can you speak to why the request is still for "Isolation", instead of "OData-Isolation"?

Cheers,


> On 7 Dec 2018, at 5:05 am, Chet Ensign <chet.ensign@oasis-open.org> wrote:
> 
> 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: +1 973-996-2298
> Mobile: +1 201-341-1393 
> _______________________________________________
> Ietf-message-headers mailing list
> Ietf-message-headers@ietf.org
> https://www.ietf.org/mailman/listinfo/ietf-message-headers

--
Mark Nottingham   https://www.mnot.net/