Change readiness status

Use this resource to manually set the readiness status of the Process Engine to READY or NOT READY. The final status also depends on the current maintenance mode activity. If the maintenance mode is active, the status is always NOT READY. If the maintenance mode is inactive, the status corresponds to the manually set status. When the status is READY, the endpoint returns HTTP status 200. When the status is NOT READY, the endpoint returns HTTP status 500.

Request

To change the readiness status, send a POST request to the endpoint defined below.

URL: /ready/{status}

Method: POST

Authorization: required (user with role System Administrator)

POST /ibis/rest/ready/off HTTP/1.1
Accept: */*
Host: localhost:8080

Path Parameters

The following table lists the parameters for this request.

Name Description Required Allowed values

Name	Description	Required	Allowed values
`status`	Enter the desired readiness status of the Process Engine.	yes	`on` (READY) or `off` (NOT READY)

status

Enter the desired readiness status of the Process Engine.

yes

on (READY) or off (NOT READY)

Response

The response indicates the result of the operation.

HTTP/1.1 500 ERROR
Content-Type: application/json

{
  "status": "NOT READY",
  "message": "No Service."
}

Errors

This request might return one of the following error codes:

Authorization Failed (401): Authorization with the given username and password failed. Please revisit both values and provide valid credentials.

<html>

    <head>
        <title>Status page</title>
    </head>

    <body style="font-family: sans-serif;">
        <p style="font-size: 1.2em;font-weight: bold;margin: 1em 0px;">Unauthorized</p>
        <p>The request requires user authentication</p>
        <p>You can get technical details <a
                href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2">here</a>.<br>
            Please continue your visit at our <a href="/">home page</a>.
        </p>
    </body>
</html>

Server Error (500): Execution on the INUBIT server failed. Have a look into the response message, otherwise access to the INUBIT log is required to retrieve further information.
Service Unavailable (503): In maintenance mode the INUBIT server endpoint will not respond to incoming requests but return this error response. Once the maintenance mode is switched off the endpoint will respond normally.