cluster.delete-eks

Delete an AWS EKS managed nodegroup and control plane through reusable EKS atomics.

Overview

Property	Value
Workflow type	Dag
Library	App-clusters-aws
Version	1.0

Input Schema

Field	Type	Required	Default	Description
aws_connection_uuid	uuid	Yes	—	AWS CloudConnection UUID used for provider calls.
cluster_name	string	Yes	—	EKS cluster name.
region	string	Yes	—	AWS region.
nodegroup_name	string	Yes	—	Managed nodegroup name created by provision-eks.
cluster_timeout_seconds	integer	No	—	Timeout while waiting for EKS control-plane deletion.
nodegroup_timeout_seconds	integer	No	—	Timeout while waiting for EKS nodegroup deletion.
poll_interval_seconds	integer	No	—	Poll interval for EKS delete waiters.
ignore_missing	boolean	No	—	Treat missing cluster or nodegroup as successful deletion.

Output Schema

Field	Type	Required	Default	Description
aws_connection_uuid	uuid	Yes	—	AWS CloudConnection UUID used for provider calls.
cluster_name	string	Yes	—	EKS cluster name.
region	string	Yes	—	AWS region.
nodegroup_name	string	Yes	—	Managed nodegroup name created by provision-eks.
cluster_timeout_seconds	integer	No	—	Timeout while waiting for EKS control-plane deletion.
nodegroup_timeout_seconds	integer	No	—	Timeout while waiting for EKS nodegroup deletion.
poll_interval_seconds	integer	No	—	Poll interval for EKS delete waiters.
ignore_missing	boolean	No	—	Treat missing cluster or nodegroup as successful deletion.
delete_nodegroup	json	No	—	Output from aws.eks.delete_nodegroup.
wait_nodegroup_deleted	json	No	—	Output from aws.eks.wait_nodegroup_deleted.
delete_cluster	json	No	—	Output from aws.eks.delete_cluster.
wait_cluster_deleted	json	No	—	Output from aws.eks.wait_cluster_deleted.
provider_cluster_ref	string	No	—	Deleted EKS cluster name or ARN.
deleted	boolean	No	—	True when the requested resources are absent.
status	string	No	—	Aggregated delete status.
completed_at	string	No	—	ISO-8601 completion timestamp.
workflow_run_uuid	string	No	—	Engine DAG run UUID for child step state.
failure_reason	string	No	—	Engine failure reason.
failed_step	json	No	—	Failed DAG step.
failed_layer	json	No	—	Failed DAG layer.
failed_at_state	json	No	—	Failed state metadata.
error	string	No	—	Error message.
error_type	string	No	—	Error class.
compensation_trigger	json	No	—	DAG compensation trigger.
comp_current_layer	json	No	—	Current compensation layer.
comp_queue	json	No	—	Remaining compensation queue.
comp_retry_count	json	No	—	Current compensation retry count.

DAG Layers

#	Layer	Steps	Compensation
1	delete_nodegroup	aws.eks.delete_nodegroup	—
2	wait_nodegroup_deleted	aws.eks.wait_nodegroup_deleted	—
3	delete_cluster	aws.eks.delete_cluster	—
4	wait_cluster_deleted	aws.eks.wait_cluster_deleted	—

Execution Flow

Sub-workflows

Sub-workflow	Step name
aws.eks.delete_nodegroup	delete_nodegroup
aws.eks.wait_nodegroup_deleted	wait_nodegroup_deleted
aws.eks.delete_cluster	delete_cluster
aws.eks.wait_cluster_deleted	wait_cluster_deleted

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "cluster.delete-eks",
  "initial_data": {
    "aws_connection_uuid": "value",
    "cluster_name": "value",
    "region": "value",
    "nodegroup_name": "value"
  }
}