W3C home > Mailing lists > Public > ietf-http-wg@w3.org > April to June 2012

Re: #347: clarify that 201 can imply *multiple* resources were created

From: Julian Reschke <julian.reschke@gmx.de>
Date: Thu, 21 Jun 2012 08:46:43 +0200
Message-ID: <4FE2C353.8030206@gmx.de>
To: Mark Nottingham <mnot@mnot.net>
CC: HTTP Working Group <ietf-http-wg@w3.org>
On 2012-06-21 05:20, Mark Nottingham wrote:
> <http://trac.tools.ietf.org/wg/httpbis/trac/ticket/347>
>
> Proposal is to replace <https://svn.tools.ietf.org/svn/wg/httpbis/draft-ietf-httpbis/latest/p2-semantics.html#status.201> with:
>
> ""
> The request has been fulfilled and has resulted in one or more new resources being created.
>
> Newly created resources are typically linked to from the response payload, with the most relevant URI also being carried in the Location header field. If the newly created resource's URI is the same as the Effective Request URI, this information can be omitted (e.g., in the case of a response to a PUT request).
>
> The origin server must create the resource(s) before returning the 201 status code. If the action cannot be carried out immediately, the server should respond with 202 (Accepted) response instead.
>
> A 201 response may contain an ETag response header field indicating the current value of the entity-tag for the representation of the resource identified by the Location header (see Section 2.3 of [Part4]).
> """
>
> Comments?

Sounds good with s/mayshouldmust/MAYSHOULDMUST/ (I assume that was a 
copy/paste problem...)

Best regards, Julian
Received on Thursday, 21 June 2012 06:47:18 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 21 June 2012 06:47:34 GMT