ETag Header: Clarify meaning of "individual resource".

XMLWordPrintable

    • Type: Improvement
    • Resolution: Fixed
    • Priority: Major
    • V4.01_WD01
    • Affects Version/s: V4.01_WD01
    • Component/s: Protocol
    • None
    • Environment:

      [Proposed]

    • Hide

      Clarify that etags MAY be on collections. If present on the collection, the service MUST support if-match/if-not-match on get, if-match on post; client MUST specify if-match when posting to the collection (i.e., action) (and can use if-match=* to force operation).

      Show
      Clarify that etags MAY be on collections. If present on the collection, the service MUST support if-match/if-not-match on get, if-match on post; client MUST specify if-match when posting to the collection (i.e., action) (and can use if-match=* to force operation).

      Chapter 11.5.4.1 "Invoking an Action" reads:
      "...
      To request processing of the action only if the binding parameter value, an entity or collection of entities, is unmodified, the client includes the If-Match header with the latest known ETag value for the entity or collection of entities. The ETag value for a collection as a whole is transported in the ETag header of a collection response.
      ..."

      --> We support ETags for collections via the standart ETag Header.

      Looking at the chapter 8.3.1 "Header ETag" we never mentioned collections; we described the usage of ETags for metadata responses, service document reponses and for requests that returns an "individual resource".
      The formulation "individual resource" is fuzzy and needs to be clarified.

            Assignee:
            Unassigned
            Reporter:
            martinzurmuehl
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: