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: 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'