Jump to: navigation, search

Set Server Mode

Error creating thumbnail: Unable to save thumbnail to destination
POST /server/mode

Description

Manages the UCS Mode for the Context Services. Two modes are available: Maintenance and Production.

  • If the server switches from maintenance to production mode, the system waits a configured amount of time (default 1 minute) for the completion of all schema management requests (see Schema Operations).
  • If the server switches from production to maintenance mode, the system waits for outstanding profile or service-related functions to complete.
    While the system is attempting to switch modes, all web service requests are denied with HTTP Status Code 503 (Service Unavailable).
Error creating thumbnail: Unable to save thumbnail to destination

Read the Server Mode page of the developer's guide for further details about maintenance and production mode.

Operation

ID CV.WS.MODE
Method POST
URL /server/mode
Parameter   Type   Mandatory Description
mode token
  • maintenance
  • production
yes The mode to set (case-insensitive).

Response

The UCS Server status is returned as a JSON object with the following fields: The Context Management Service API answers with HTTP codes for every request. The following table shows the correct response for a successful request. See HTTP Response Codes and Errors for further details on the possible codes that this operation can return.

Response
HTTP code 200
HTTP message OK
Header Location /server/status
Body {"server changed":"${mode}"}

where:

  • ${mode} is the string for the new UCS mode (production or maintenance).

Example

Operation

 POST /server/mode
{"mode":"production"}

Result

{"server changed":"production"}
This page was last edited on September 12, 2016, at 14:01.
Comments or questions about this documentation? Contact us for support!