Skip to main content

Error handling

When a REST request fails, the HTTP response code is set to an error code. Information about the error is returned in the payload as an error response.

An error response has the following structure:

Class: AemClientException that inherits from Exception class and has the following fields:

ErrorCode

Message

This section lists the generic messages that apply to most of the API functions. Errors that are specific to a particular API function appear in the section for that API function.

Error responses
Error Message Description
UNAUTHORIZED_REQUEST

Unauthorized Request.

The user is not authorized to perform the requested action (for example, deleting a task).

INVALID_SESSION_ID The session has expired or the session ID is not valid. Session expired or invalid.

DESERIALIZE_TO_TYPE

Failed to deserialize json to type {type}: {message}

Returned when the JSON format is invalid.

AEM_SERVER_NOT_FOUND The requested server {server} could not be found. The requested server cannot be found.
AEM_SERVER_NOT_MONITORED The requested server {server} is not monitored. The requested server is not being monitored and thus the information is not accessible.
AEM_SERVER_NOT_CONNECTED

The requested server "{server}" cannot be reached at this time.

Message: {message}

The desired information cannot be retrieved as the requested server is not connected.

AEM_SERVER_LICENSE_EXPIRED

The license for requested server {server} has expired. The requested server license has expired.

AEM_SERVER_INVALID_LICENSE

The license for requested server {server} is not valid.

The requested server license is not valid.

LICENSE_NOT_FOUND

You need to register a Replication Management license in order to use Qlik Enterprise Manager. To register or obtain a license, open the Qlik Enterprise Manager console and follow the instructions.

Replication Management license was not found. Returned when a user is permitted to Register Qlik Enterprise Manager license.

LICENSE_NOT_FOUND_CONTACT_ADMIN

An Enterprise Manager Admin needs to register a Replication Management license before you can use the product. To obtain a license, contact your Qlik Sales Representative with the Enterprise Manager machine name (which is displayed when you open the Enterprise Manager console).

Replication Management license was not found. Returned when a user is NOT permitted to Register Qlik Enterprise Manager license.

LICENSE_EVALUATION_EXPIRED

{Module} evaluation license has expired.

{Module} is one of the following:

  • Replication Management
  • Replication Analytics

LICENSE_TERM_EXPIRED

{Module} license has expired.

{Module} is one of the following:

  • Replication Management
  • Replication Analytics

LICENSE_INVALID_SIGNATURE

The {Module} license signature is invalid.

{Module} is one of the following:

  • Replication Management
  • Replication Analytics

LICENSE_HOST_MISMATCH

The host name in the {Module} license does not match the Enterprise Manager machine name.

{Module} is one of the following:

  • Replication Management
  • Replication Analytics

AEM_MISSING_FIELD

The "{fieldName}" field is missing from the request.

When a mandatory field is missing from the request or appears empty.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!