Uploaded image for project: 'OASIS Open Data Protocol (OData) TC'
  1. OASIS Open Data Protocol (OData) TC
  2. ODATA-924

Define semantics for PUT against a single entity with nested content

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: V4.0_ERRATA03
    • Fix Version/s: V4.01_WD01
    • Component/s: Protocol
    • Labels:
      None
    • Environment:

      [Proposed]

    • Proposal:
      Hide

      Align Semantics of PUT with PATCH, as specified in ODATA-876, by specifying that, when you do a PUT,
      1) You can include new nested entities, existing entities, and references to existing entities
      2) Existing entities are updated using PUT semantics
      a) entities to be updated must have either @odata.id or key fields, otherwise interpreted as an insert
      b) if @odata.id and key fields both exist but don't match, then request is invalid
      3) The end result of the PUT is that the specified entities and entity references are the full set of entities related according to that relationship.

      Show
      Align Semantics of PUT with PATCH, as specified in ODATA-876 , by specifying that, when you do a PUT, 1) You can include new nested entities, existing entities, and references to existing entities 2) Existing entities are updated using PUT semantics a) entities to be updated must have either @odata.id or key fields, otherwise interpreted as an insert b) if @odata.id and key fields both exist but don't match, then request is invalid 3) The end result of the PUT is that the specified entities and entity references are the full set of entities related according to that relationship.

      Description

      In ODATA-666 we defined semantics for a PATCH request to a single entity or collection of entities that contained nested entities.

      We said it didn't make sense to do a PUT against a collection of entities, but need to define the semantics (if allowed) of a PUT operation against a single entity where the payload contains nested entities.

        Attachments

          Activity

            People

            • Assignee:
              mikep Michael Pizzo
              Reporter:
              mikep Michael Pizzo
            • Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: