Berlioz status

Status that can be returned from generators and services and corresponding the HTTP parameters.

Generators must all returns a status. Berlioz computes the status for the service based on the status of each generator.

This can be controlled using the <response-code> element in the services.xml. The default rule is to use the highest values of all the statuses returned by the generators in a service.


NameHTTP CodeDescription
ok200The request has succeeded.
created201The request has been fulfilled and resulted in a new resource being created.
accepted202The request has been accepted for processing, but the processing has not been completed.
no_content204The server has fulfilled the request but does not need to return any content. Berlioz will not send any content with the request.
reset_content205The server has fulfilled the request and the user agent SHOULD reset the document view which caused the request to be sent. Berlioz will not send any content with the request.



NameHTTP CodeDescription
moved_permanently301The requested resource has been assigned a new permanent URI and any future references to this resource SHOULD use one of the returned URIs.
found302The requested resource resides temporarily under a different URI. Since the redirection might be altered on occasion, the client SHOULD continue to use the Request-URI for future requests.
see_other303The response to the request can be found under a different URI and SHOULD be retrieved using a GET method on that resource.
temporary_redirect307The requested resource resides temporarily under a different URI.


Client errors

NameHTTP CodeDescription
bad_request400The request could not be understood by the server due to malformed syntax. The client SHOULD NOT repeat the request without modifications.
forbidden403The server understood the request, but is refusing to fulfill it.
not_found404The server has not found anything matching the Request-URI.
conflict409The request could not be completed due to a conflict with the current state of the resource.
gone410The requested resource is no longer available at the server and no forwarding address is known.


Where is 401? At present, Berlioz isn't designed to implement the security layer. It can however indicate when access to a resource is forbidden using 403.

Server errors

NameHTTP CodeDescription
internal_server_error500The server encountered an unexpected condition which prevented it from fulfilling the request.
not_implemented501The server does not support the functionality required to fulfill the request.
bad_gateway502The server, while acting as a gateway or proxy, received an invalid response from the upstream server it accessed in attempting to fulfill the request.
service_unavailable503The server is currently unable to handle the request due to a temporary overloading or maintenance of the server.
gateway_timeout504The server, while acting as a gateway or proxy, did not receive a timely response from the upstream server specified by the URI or some other auxiliary server it needed to access in attempting to complete the request.


Created on , last edited on