[OASIS Issue Tracker] (ODATA-1638) Clarify creation of a singleton media entity

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

Michael Pizzo created ODATA-1638:
------------------------------------

             Summary: Clarify creation of a singleton media entity
                 Key: ODATA-1638
                 URL: https://issues.oasis-open.org/browse/ODATA-1638
             Project: OASIS Open Data Protocol (OData) TC
          Issue Type: New Feature
          Components: Protocol
    Affects Versions: V4.01_OS
         Environment: [Proposed]
            Reporter: Michael Pizzo
             Fix For: V4.01_ERRATA01


11.4.7.1 Create a Media Entity in [Protocol] describes how to create a media entity within a collection. It doesn't mention how to create a singleton contained media entity.

11.4.7.2 Update a Media Entity Stream says that, to update, you would submit a request to the media edit link (the editlink of the entity suffixed with /$value).

Presumably, creation of a singleton contained media entity would be done by calling PUT to the media entity link, which should return 201 created and a location header, and may set other properties of the entity, but this is not called out.

11.4.4 Upsert an Entity calls out that it's not possible to upsert a media entity, which is correct but misleading.  PUT to the media edit link replaces the media. As above, if the entity doesn't already exist it will be created with the new stream value. In either case, additional properties of the entity may be set.



--
This message was sent by Atlassian Jira
(v8.3.3#803004)