Clusters

Delete multiple cluster nodes

Deletes one or more nodes (worker or master) from a specific Kubernetes cluster. Provide the target cluster_id in the path and an array of node ids in the request body.

Minimum node requirements: Each node group must retain at least one worker node, and each cluster must retain at least two master nodes. Deletion requests that would violate either of these minimums are rejected.

post/core/clusters/{cluster_id}/nodes/delete

Request

  • Base URL: https://infrahub-api.nexgencloud.com/v1
  • URL: https://infrahub-api.nexgencloud.com/v1/core/clusters/{cluster_id}/nodes/delete
  • Auth: API key in header api_key

Path parameters

cluster_idinteger required

ID of the cluster.

Request body

idsinteger[]

An array of one or more node IDs (worker or master) to be deleted from the specified Kubernetes cluster. Only nodes with the roles worker or master may be deleted.

Response

Success

statusboolean

Whether the request succeeded.

messagestring

Human-readable description of the result.

Example response

{
  "status": true,
  "message": "Instance is being deleted."
}

Changes

No recorded changes to this operation across all 1 revision of this API.