Error handling for the Infrastructure Management REST API


HTTP header error codes

HTTP error codes are displayed in the HTTP header. These error codes represent a broader category of the actual issue. For more granular details about the error, you must look at the JSON response error codes that are covered in each topic.

HTTP error codes for REST API

Error code

Message

Description

200

Success

Your request was successful.

203

Non-Authoritative Information

Your request has generated a partial response. Contact your administrator for more information.

400

Bad Request

Your request has incorrect parameters or formatting errors.

401

Authentication failed. Invalid Username/Password OR Invalid/Expired Token.

The authentication credentials or the authentication token is incorrect, invalid, or not provided.

403

Access denied. You are not authorized to perform this operation.

Your authentication credentials are valid, but your user role is not authorized to access the resource.

404

Not Found

The resource is not found or does not exist.

408

Request Timeout

The server timed out waiting for the client's request.

500

Internal Server Error

There is some internal issue in BMC TrueSight Infrastructure Management Server.

501

Not Implemented

Either the server does not recognize your request method or it does not have the ability to implement your request.

503

Service Unavailable

The server is temporarily unable to process your request. It might be mostly due to server overload or unavailability.

JSON error codes to retrieve data from Infrastructure Management

This section lists the JSON error codes that these REST APIs can display.


JSON error codes displayed by the APIs that retrieve data

JSON error codes for REST APIs that manage CIs

This section lists the JSON error codes that these REST APIs can display.


JSON error codes for the APIs that manage CIs

JSON error codes for REST APIs that manage events

This section lists the JSON error codes that the REST APIs can display.

JSON error codes for the APIs that manage events

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*