Zhijie Shen created YARN-2401:
---------------------------------

             Summary: Rethinking of the HTTP method of 
TimelineWebServices#postEntities
                 Key: YARN-2401
                 URL: https://issues.apache.org/jira/browse/YARN-2401
             Project: Hadoop YARN
          Issue Type: Sub-task
          Components: timelineserver
            Reporter: Zhijie Shen
            Assignee: Zhijie Shen


Now TimelineWebServices#postEntities is using POST. However, semantically, 
postEntities is creating an entity or append more data into it. POST may not be 
the most proper method to for this API.

AFAIK, PUT is used to update the entire resource and supposed to be idempotent. 
Therefore, I'm not sure it's an idea to change the method to PUT because once 
the entity is created, the following updates are actually appending more data 
to the existing one. The best fit should be PATCH, however, it requires the 
additional implementation at the web services side. Hence, somebody online 
suggested using POST for partial non-idempotent update as well. We need to 
think more about it.



--
This message was sent by Atlassian JIRA
(v6.2#6252)

Reply via email to