You’re correct, a PUT is a full replace. (Way back when, I think we discussed including a PATCH method too, but discarded it as too complex.) The spec isn’t ambiguous because PUT means full replacement (here’s a discussion <http://stackoverflow.com/questions/19732423/why-isnt-http-put-allowed-to-do-partial-updates-in-a-rest-api> :-), but it wouldn’t hurt to clarify in belt-and-suspenders fashion if someone wants to put in an issue about it. Eve
On 16 Jul 2015, at 5:07 AM, Justin Richer <jricher@mit.edu> wrote:
I believe it's supposed to send all the attributes to comply with common RESTful design (a PUT is a full replace, a PATCH would be a partial update), though the spec is also ambiguous about that.
-- Justin
On 7/16/2015 8:06 AM, Farazath Ahamed wrote:
Thanks Justin
And for a small clarification,
Does the resource set description sent with a HTTP PUT only include the attributes to updated or the whole resource set description of the resource set?
On Thu, Jul 16, 2015, 5:28 PM Justin Richer < <mailto:jricher@mit.edu>jricher@mit.edu <mailto:jricher@mit.edu>> wrote: You're correct, the example is wrong, and the normative text is ambiguous as it doesn't specify a response code. We implemented this as a 200. Additionally, we return the full entity on update since the text says the response "must include the _id" but doesn't specify whether or not to include anything else:
https://github.com/mitreid-connect/OpenID-Connect-Java-Spring-Server/blob/ma... <https://github.com/mitreid-connect/OpenID-Connect-Java-Spring-Server/blob/master/uma-server/src/main/java/org/mitre/uma/web/ResourceSetRegistrationEndpoint.java#L202-L204>
I'd file a new bug.
-- Justin
On 7/15/2015 9:30 PM, Farazath Ahamed wrote:
Hi,
The method described in the spec to update Resource Set descriptions[1] is supposed to return a HTTP 204 including the _id value of the successfully updated resource set description.
but the HTTP Status Code Definition for 204 says, The 204 response MUST NOT include a message-body, and thus is always terminated by the first empty line after the header fields.
Therefore is it correct to include a body in a 204. Is it possible to do that? Am I missing a trick here?
[1] https://docs.kantarainitiative.org/uma/draft-oauth-resource-reg.html#rfc.sec... <https://docs.kantarainitiative.org/uma/draft-oauth-resource-reg.html#rfc.section.2.3.3>
Thanks, --
A.Farasath Ahamed
Undergraduate | Department of Computer Science and Engineering,University of Moratuwa Article Writer | MoraSpirit Mobile: +94 777 603 866
Blog: http://thepseudocode.blogspot.com <http://thepseudocode.blogspot.com/> E-Mail: <mailto:mefarazath@gmail.com>mefarazath@gmail.com <mailto:mefarazath@gmail.com>
_______________________________________________ WG-UMA mailing list WG-UMA@kantarainitiative.org http://kantarainitiative.org/mailman/listinfo/wg-uma
Eve Maler | cell +1 425.345.6756 | Skype: xmlgrrl | Twitter: @xmlgrrl | Calendar: xmlgrrl@gmail.com