Shut down cluster
editShut down cluster
editThis endpoint is deprecated and scheduled to be removed in the next major version. Use shutdown resource instead.
Shuts down a running cluster and removes all nodes belonging to the cluster. The cluster definition is retained. Warning: this will lose all cluster data that is not saved in a snapshot repository.
Request
editPOST /api/v1/clusters/apm/{cluster_id}/_shutdown
Path parameters
editName | Type | Required | Description |
---|---|---|---|
|
|
Y |
The APM deployment identifier. |
Query parameters
editName | Type | Required | Description |
---|---|---|---|
|
|
N |
Hides the clusters during shutdown. NOTE: By default, hidden clusters are not listed. |
Responses
edit-
202
-
The shutdown 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
-
-
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/apm/{cluster_id}/_shutdown \ -H "Authorization: ApiKey $ECE_API_KEY"