Errors and status codes
All supported status codes follow the HTTP/1.1 protocol. For a list describing HTTP/1.1 status codes, see Status Code Definitions.
Limitations: In some cases, REST API error messages are displayed in English even if ALM Octane has been localized for a specific language.
All status codes
Below you can find a list of ALM Octane supported status codes:
Code |
Name |
Functionality |
---|---|---|
200 |
OK |
|
201 |
Created |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not Allowed |
|
406 |
Not Acceptable |
|
408 |
Request Timeout |
|
409 |
Conflict |
|
415 |
Unsupported Media Type |
|
500 |
Internal Server Error |
|
501 |
Not Implemented |
|
503 | Service Unavailable |
|
Logs and correlation IDs
If an error occurs while processing a request, ALM Octane sends the details to logs. Included in the details are correlation IDs. Provide the correlation IDs when contacting customer support.
{"error_code":"platform.general_error","correlation_id":"dn2wp6xe9qvgmsv8lvelp74r1","description":"General error occurred","description_translated":"General error occurred","properties":null}
Business error property
A business_error value might be included in the response if an error of a business nature occurs, such as a duplicate name or an entity failing rule validation.
The following code shows an example of a returned business error:
{
"error_code": "platform.duplicate_entity_error",
"correlation_id": "yevz2e7v003q4f3g41wqp8qr1",
"description": "A release with this Name already exists.",
"business_error": true
}
where:
- error_code. The error code value to be used when contacting support to provide more context for root cause of error.
- correlation_id. A unique ID of the operation in which error occurred, to be used when contacting support to give context to the error. This value can be used to track down all Octane server log entries which were logged during same operation.
- description. A short description of the error.
business_error. A boolean value.
- true indicates bad user input. If true is returned, check that you are using the API correctly.
- false indicates an unexpected state of the system, such as losing the connection to a database. If false is returned, you most likely will need to contact the system administrator and report the problem.