Remove "MERGE", use "PATCH" instead

    • Type: Bug
    • Resolution: Fixed
    • Priority: Minor
    • None
    • Affects Version/s: None
    • Component/s: Protocol
    • None
    • Environment:

      [Proposed]

    • Hide

      1. In Section 8.2.4, "The If-Match Request Header", remove "MERGE," from the list of verbs specified.
      2. In Section 8.2.5, "The If-None-Match Request Header", remove "MERGE," from the list of verbs specified.
      3. In Section 8.5.1, "The DataServiceId Header", remove "MERGE," from the list of verbs specified.
      4. In Section 9.1.1., "The 200 OK Response Code", remove ",MERGE" from the list of verbs specified.
      5. In Section 10.3.1.2., "Differential Update":
      a) Remove "or MERGE" from the paragraph that begins "A PATCH or MERGE"
      b) Remove the paragraph that begins "The HTTP MERGE verb is defined in this document."
      c) Delete the paragraph that begins "The semantics of a MERGE request..."
      d) Replace the paragraph that begins "The semantics of the PATCH request." with the following:
      "The semantics of a PATCH request, as defined in [RFC5789], are to merge the content in the request payload with the entity's current state, applying the update only to those properties specified in the request body."
      6. In Section 10.3.3., "Update an Entity", remove "MERGE," from the list of verbs specified.
      7. In Section 10.3.8.1., "Update a Primitive Property", remove "MERGE," from the list of verbs specified.
      8. In Section 10.3.8.3., "Update a Complex Type", remove "MERGE, from the list of verbs specified.
      9. In Section 10.4.3.3., "Invoking a Function", remove "MERGE, from the list of verbs specified.

      Show
      1. In Section 8.2.4, "The If-Match Request Header", remove "MERGE," from the list of verbs specified. 2. In Section 8.2.5, "The If-None-Match Request Header", remove "MERGE," from the list of verbs specified. 3. In Section 8.5.1, "The DataServiceId Header", remove "MERGE," from the list of verbs specified. 4. In Section 9.1.1., "The 200 OK Response Code", remove ",MERGE" from the list of verbs specified. 5. In Section 10.3.1.2., "Differential Update": a) Remove "or MERGE" from the paragraph that begins "A PATCH or MERGE" b) Remove the paragraph that begins "The HTTP MERGE verb is defined in this document." c) Delete the paragraph that begins "The semantics of a MERGE request..." d) Replace the paragraph that begins "The semantics of the PATCH request." with the following: "The semantics of a PATCH request, as defined in [RFC5789] , are to merge the content in the request payload with the entity's current state, applying the update only to those properties specified in the request body." 6. In Section 10.3.3., "Update an Entity", remove "MERGE," from the list of verbs specified. 7. In Section 10.3.8.1., "Update a Primitive Property", remove "MERGE," from the list of verbs specified. 8. In Section 10.3.8.3., "Update a Complex Type", remove "MERGE, from the list of verbs specified. 9. In Section 10.4.3.3., "Invoking a Function", remove "MERGE, from the list of verbs specified.
    • Show
      Resolved as proposed by removing references to MERGE. Applied in https://www.oasis-open.org/apps/org/workgroup/odata/download.php/46906/odata-v1.0-wd01-2012-9-12.doc . Accepted: https://www.oasis-open.org/committees/download.php/46960/odata_meeting-8_on-20120920_minutes.html

      the "MERGE" verb was introduced in an early version of OData in order to support updating only the subset of fields specified in an update request. HTTP has since added a "PATCH" verb with the same semantics, and the two are defined as synonyms in [OData-Core]. To avoid creating legacy we should drop the "MERGE" verb from the OASIS specification.

            Assignee:
            Michael Pizzo
            Reporter:
            Michael Pizzo
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved: