Restart cluster
editRestart cluster
editThis endpoint is deprecated and scheduled to be removed in the next major version. Use restart resource instead.
Restarts the Kibana instance. When you restart an active instance, the existing plan is used and a cluster_reboot
is applied. A cluster_reboot
issues a Kibana restart command, then waits for the command to complete. When you restart an inactive instance, the most recent successful plan is applied.
Request
editPOST /api/v1/clusters/kibana/{cluster_id}/_restart
Path parameters
editName | Type | Required | Description |
---|---|---|---|
|
|
Y |
The Kibana deployment identifier. |
Query parameters
editName | Type | Required | Description |
---|---|---|---|
|
|
N |
When |
Responses
edit-
202
-
The stop command was issued successfully, use the "GET" command on the /{cluster_id} resource to monitor progress
-
404
-
The cluster specified by {cluster_id} cannot be found. (code:
clusters.cluster_not_found
)Headers
-
x-cloud-error-codes
(string
; allowed values: [clusters.cluster_not_found
]) - The error codes associated with the response
-
-
412
-
The command sent to a cluster found the cluster in an illegal state, the error message gives more details. (code:
clusters.cluster_plan_state_error
)Headers
-
x-cloud-error-codes
(string
; allowed values: [clusters.cluster_plan_state_error
]) - The error codes associated with the response
-
-
449
-
Elevated permissions are required. (code:
root.unauthorized.rbac.elevated_permissions_required
)Headers
-
x-cloud-error-codes
(string
; allowed values: [root.unauthorized.rbac.elevated_permissions_required
]) - The error codes associated with the response
-
Request example
editcurl -XPOST https://{{hostname}}/api/v1/clusters/kibana/{cluster_id}/_restart \ -H "Authorization: ApiKey $ECE_API_KEY"