Restart the Service Instance (v2)

Use this REST API to restart the service instance.

This topic describes the simplified v2 version of this REST API. This version contains all parameters in the payload and does not require URL encoding while calling the REST APIs. This makes the v2 API easier to use. This API is backwards compatible.

You can also use an optional AutoTune parameter to auto-tune the environment before restarting it to ensure that Essbase index caches for Block Storage Option (BSO) cubes are optimized for your application.

Required Roles

Service Administrator

REST Resource

POST /interop/rest/v2/config/services/reset

Request

Supported Media Types: application/json

Payload: JSON

Table 9-39 Parameters

Name Description Type Required Default
comment Comment about executing the restart Payload Yes None
autotune If set to true, runs the auto tune algorithm before the restart. This ensures that Essbase index caches for BSO cubes are optimized for your application. Payload No false

Example of Request Body

{
  "comment": "Reset requested by Administrator",
  "parameters": {
     "autotune": "false" 
  }
}

Response

Table 9-40 Parameters

Name Description
Details In case of errors, details are published with the error string
Status See Migration Status Codes
Links Detailed information about the link
Href Links to API call or status API
Action The HTTP call type
Rel

Possible values: self and/or Job Status.

If the value is set to Job Status, you can use the href to get the status of the reset service

Data Parameters as key value pairs passed in the request

Example of Response Body

{
	"details": null,
	"status": 0,
	"links": [{
		"href": "https://<BASE-URL>/interop/rest/v2/config/services/reset",
		"rel": "self",
		"data": null,
		"action": "POST"
	},
	{
		"href": "https://<BASE-URL>/interop/rest/v2/config/status/service/hardreset/1",
		"rel": "Job Status",
		"data": null,
		"action": "GET"
	}]
}

Sample cURL Command

curl -X POST -s -u '<USERNAME>:<PASSWORD>' -o response.txt -D respHeader.txt -H 'Content-Type: application/json' -d ' {"comment":"<COMMENT>","parameters":{"autotune":"false"}}' 'https://<BASE-URL>/interop/rest/v2/config/services/reset'