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

Error code

Message

Description

BPPM-RWS50000E

An internal server error occurred. Contact your administrator.

An internal error occurred in TrueSight Infrastructure Management Server. Contact your administrator for more information.

BPPM-RWS50001E

Invalid license. Contact Infrastructure Management Support to acquire a valid license.

Your Infrastructure Management license is invalid. Contact Infrastructure Management Support.

BPPM-RWS50002E

BMC TrueSight Infrastructure Management Server is busy. Try after n seconds.

The server is currently busy. Try sending the request again after n seconds. n is a numeric value.

BPPM-RWS50005E

Unable to operationName all the given CI(s). listOfCIs

The web service request is not able to perform the specified operation on the given CIs. operationName is the operation that failed, and listOfCIs is the list of CIs that failed the specified operation.

200

OK

Your request has a successful response.

BPPM-RWS40000E

Validation failure

Validation of some parameters or JSON inputs failed.

BPPM-RWS40001E

Required input parameter parameterName is not found.

An input parameter is not provided. parameterName is the name of the parameter that is not provided.

BPPM-RWS40002E

The value of input parameter parameterName is invalid. Value entered: parameterValue

The value of the parameter that is provided is invalid. parameterName is the name of the parameter, and parameterValue is the invalid value.

BPPM-RWS40003E

Format of parameterName is incorrect. The correct format is idealFormat

The format of the input parameter in the request is incorrect. parameterName is the name of the parameter, and idealFormat is the correct format for the parameter.

BPPM-RWS40004E

Start time must be less than end time.

The start time in your request is greater than the end time.

BPPM-RWS40005E

Both start time and end time are required.

Either the start time or the end time is missing in your request.

BPPM-RWS40006E

Time interval parameters are not supported by a metadata request.

A metadata request does not require start time and end time parameters.

BPPM-RWS40007E

A monitor instance is not supported as a resource for a metadata request.

A metadata request does not support a monitor instance as a resource.

BPPM-RWS40008E

A monitor type is not supported as a resource for a metadata request.

A metadata request does not support a monitor type as a resource.

BPPM-RWS40009E

A monitor type is not supported as a resource for a stats request.

A performance statistics request does not support a monitor type as a resource.

BPPM-RWS40010E

Monitor attributes are not supported for a stats request if the resource is a monitor instance.

A performance statistics request does not support monitor attributes for a monitor instance resource.

BPPM-RWS40011E

Monitor and attributes must be provided for a stats request if the resource is a device.

A performance statistics request must be provided with monitor attributes if the resource is a device.

BPPM-RWS40012E

Monitor and attributes must be provided for a stats request if the resource is a group.

A performance statistics request must be provided with monitor attributes if the resource is a group.

BPPM-RWS40013E

Monitor attributes are not be supported for a metadata request.

A metadata request does not support any monitor attributes.

BPPM-RWS40014E

A monitor instance is not supported as a resource for a configdata request.

A configdata request does not support a monitor instance as a resource.

BPPM-RWS40015E

The value of input parameter parameterName is invalid.

The value of the parameter that is provided is invalid. parameterName is the name of the parameter that has an invalid value.

BPPM-RWS40016I

Specified parameter parameterName is currently not supported.

A parameter in your request is currently not supported. parameterName is the name of the parameter that is not supported.

BPPM-RWS40017E

Specified time interval exceeds the permissible limit of n days.

The interval between the start time and the end time exceeds the permissible limit. n is a numeric value.

BPPM-RWS40018E

Duplicate resource(s) found.

Two or more resources with the same identifier are found.

BPPM-RWS40019E

Invalid page number.

The page number you have specified in your request is not valid.

BPPM-RWS40021E

Resource ID type is invalid for a monitor instance resource. The supported ID type is URI.

The resource ID type is invalid for a monitor instance as a resource. You can provide only URI as an identifier.

BPPM-RWS40022E

Incorrect URL. Check the action parameter.

The formatting of your request is invalid, or the action specified is invalid.

BPPM-RWS40035E

The length of parameter parameterName must be in the range of a to b.

The length of the parameter value must be within the permissible limit. parameterName is the name of the parameter. a and b are the upper and lower limits.

BPPM-RWS40400E

inputParameters not found.

Your request misses few input parameters. inputParameters is the name of the parameter that is missing.

BPPM-RWS40401E

Resource not found.

The resource specified in your request is not found.

BPPM-RWS40403E

No monitor instances found.

The monitor instances specified in your request are not found.

BPPM-RWS40404E

No performance data found.

The performance statistics data is not found for the specified resource.

BPPM-RWS40405E

No attribute(s) found.

The attributes specified in your request are not found.

BPPM-RWS40406E

No data found.

No data is found.

BPPM-RWS40407E

No monitor type found.

The monitor type specified in your request is not found.

BPPM-RWS40408E

No KPI attributes found.

No KPI attributes are found for your request.

BPPM-RWS40409E

No monitor instance found.

The monitor instance specified in your request is not found.

BPPM-RWS40410E

Specified action is invalid and/or no resource is found.

Either the request type is invalid, or no valid resource is found.

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

Error code

Message

Description

BPPM-RWS50000E

An internal server error occurred. Contact your administrator.

There is some internal problem in TrueSight Infrastructure Management Server. Contact your administrator for more help.

BPPM-RWS40001E

Required input parameter parameterName is not found.

An input parameter is not provided. parameterName is the name of the parameter that is not provided.

BPPM-RWS40002E

The value of input parameter parameterName is invalid.

The value of the parameter that is provided is invalid. parameterName is the name of the parameter that has an invalid value.

BPPM-RWS40018E

Duplicate resource(s) found.

Two or more resources with the same identifier are found.

BPPM-RWS40401E

Resource not found.

The specified resource is not available.

BPPM-RWS40000E

Validation failure.

Validation of some parameters or JSON inputs failed.

BPPM-RWS20302E

The request is partially successful because operationName operation could not be ran on few resources.

The web service request could not be ran on all the requested resources. operationName is the task type that the web service request is intended to perform. For example, delete.

BPPM-RWS40302E

Access denied. Appropriate permission is needed to perform the operation.

Your credentials are not authorized to access the web service API.

BPPM-RWS40031E

Multiple identifier found. Use unique identifier.

Multiple identifier instances are found. identifier is the identifier of the CI or relationship.

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

Error code

Message

Description

BPPM-RWS50000E

An internal server error occurred. Contact your administrator.

There is some internal problem in TrueSight Infrastructure Management Server. Contact your administrator for more help.

BPPM-RWS40001E

Required input parameter parameterName is not found.

An input parameter is not provided. parameterName is the name of the parameter that is not provided.

BPPM-RWS40015E

The value of input parameter parameterName is invalid.

The value of the parameter that is provided is invalid. parameterName is the name of the parameter that has an invalid value.

BPPM-RWS40018E

Duplicate resource(s) found.

Two or more resources with the same identifier are found.

BPPM-RWS40401E

Resource not found.

The specified resource is not available.

BPPM-RWS40000E

Validation failure.

Validation of some parameters or JSON inputs failed.

Was this page helpful? Yes No Submitting... Thank you

Comments