Error handling has been completely revamped in version 1.5 and returns a detailed error message stating exactly why a request failed (i.e. parameter missing errors, resource invalid errors, cloud errors etc.). The response body will include a descriptive error message to assist you with debugging efforts, except in the event of a 500 Internal Server Error.
|HTTP Error Code||Description|
|301 Moved Permanently||An error code that indicates that the URL has been redirected to another URL. The location for the URL will be listed in the response.|
|400 Bad Request||Parameter or filter errors, e.g. missing a required parameter. The request should not be repeated without modifying it.|
|401 Unauthorized||Authentication errors, e.g. wrong username/password or wrong instance token (for instance facing sessions).|
|403 Forbidden||Authorization errors, e.g. Not having sufficient user 'roles' to perform a particular action or the account might not have the required setting. This error code can also be returned with a "Session cookie is expired or invalid" message indicating that the session has expired.|
|404 Not Found||Unknown routes, e.g. making a GET request to /api/unknown_route.|
|405 Method Not Allowed||Method not allowed errors, e.g. making a DELETE request to /api/clouds.|
|406 Not Acceptable||Unknown format error, e.g. making a GET request to /api/clouds.PDF.|
|422 Unprocessable Entity||A generic error code that indicates: resource not found (e.g. GET /api/clouds/unknown_cloud), invalid resource (e.g. an error occurred during resource creation), invalid API version (e.g. setting X_API_VERSION to 0.9), or cloud errors (e.g. trying to attach a volume to a device that is already taken).|
|500 Internal Server Error||Unknown errors, please contact support if you get this error.|
|504 Gateway Timed Out|| |
The server, while acting as a gateway or proxy, did not receive a
Note: To implementors: some deployed proxies are known to
© 2006-2014 RightScale, Inc. All rights reserved.
RightScale is a registered trademark of RightScale, Inc. All other products and services may be trademarks or servicemarks of their respective owners.