openstack/api-sig
Code Issues Proposed changes

Merge "Clarify asynchronous resource creation"

Browse Source
This commit is contained in:
Jenkins 2015-02-20 13:55:16 +00:00 committed by Gerrit Code Review
commit c0bdddf249
1 changed files with 7 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
guidelines/http.rst
View File

@ -22,11 +22,13 @@ HTTP Response Codes
* Must return a Location header with the URI of the created resource
* Should return a representation of the resource in the body
* If the API call succeeds, but the result of the call has created an
asynchronous task that will need to be polled to get completion or state
information, the return code should be **202 Accepted**, and the body of the
request should contain a link that the client can follow in order to get such
state information.
* Asynchronous resource creation
* Response status code must be ``202 Accepted``
* Must return a Location header set to one of the following:
* the URI of the resource to be created, if known.
* the URI of a status resource that the client can use to query the
progress of the asynchronous operation.
* For all other successful calls, the return code should be **200 OK**.