Changeset 1683 for draft-ietf-httpbis/latest/p2-semantics.xml

Timestamp:

Jun 21, 2012, 5:52:32 AM (7 years ago)

Author:

julian.reschke@…

Message:

Clarify that status 201 can mean that multiple resources have been created (see #347)

File:

• draft-ietf-httpbis/latest/p2-semantics.xml (modified) (4 diffs)

draft-ietf-httpbis/latest/p2-semantics.xml

@@ -1378 +1378 @@
   <iref primary="true" item="Status Codes" subitem="201 Created" x:for-anchor=""/>
 <t>
-   The request has been fulfilled and has resulted in a new resource being
-   created. 
-</t>
-<t>
-   The newly created resource is typically linked to from the response payload,
+   The request has been fulfilled and has resulted in one or more new resources
+   being created. 
+</t>
+<t>
+   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,
@@ -1389 +1389 @@
 </t>
 <t>
-   The origin server &MUST; create the resource before returning the 201 status
+   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.
@@ -1396 +1396 @@
    A 201 response &MAY; contain an ETag response header field indicating
    the current value of the entity-tag for the representation of the resource
-   just created (see &header-etag;).
+   identified by the Location header field or, in case the Location header
+   field was omitted, by the Effective Request URI (see &header-etag;).
 </t>
 </section>
@@ -6777 +6778 @@
       "ABNF requirements for recipients"
     </t>
+    <t>
+      <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/347"/>:
+      "clarify that 201 can imply *multiple* resources were created"
+    </t>
   </list>
 </t>