Response codes

Rackspace Metrics returns an HTTP code that denotes the type of response.

Successful response codes are returned only if all configured providers were successful in processing the request.
Error response codes are accompanied by an application/json response body that contains the error messages.

The following table lists possible responses with their associated codes and descriptions.

Table: List of response codes

OK - 200 - The request has succeeded. (Some API calls might return 201 instead.)

Accepted - 202 The request has been accepted for processing.

Multi-Status - 207 - The request contains multiple response statuses.

Bad request - 400 - The format of the request is invalid.

Unsupported Media Type - 415 - Either Content-Type or Accept header contains media type that is not supported.

Unauthorized - 401 Unauthorized access to the service

Internal Server Error - 500 -The system encountered an unexpected condition.

serviceUnavailable - 503 - The service is currently unavailable. For example, it might be down for scheduled platform maintenance. Try again later.

Example: Error message example

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
"title": "Unsupported limit",
"description": "The given limit cannot be negative, and cannot be greater than 50.",
"code": 1092,
"link": {
"rel": "help",
"href": "http://docs.example.com/messages#limit",
"text": "API documentation for the limit parameter"
}
}