Skip to content
Proud to collaborate with Microsoft for Startups

cluster.delete-aks ​

Delete a AKS cluster through base Azure primitives.

Overview ​

PropertyValue
Workflow typeDag
LibraryApp-clusters-azure
Version1.0

Input Schema ​

FieldTypeRequiredDefaultDescription
organization_uuiduuidNo—Organization UUID for audit and future connection cleanup.
azure_connection_uuiduuidYes—Azure CloudConnection UUID used for provider API calls.
kubernetes_connection_uuiduuidNo—Kubernetes CloudConnection UUID associated with the cluster.
resource_groupstringYes—Azure resource group.
locationstringYes—AKS region or zone.
cluster_namestringYes—AKS cluster name.
forcebooleanNo—Allow delete even when pre-delete describe reports non-ready status.
timeout_secondsintegerNo—Provider operation wait timeout.
poll_intervalintegerNo—Provider operation poll interval.

Output Schema ​

FieldTypeRequiredDefaultDescription
organization_uuiduuidNo—Echoed organization UUID.
azure_connection_uuiduuidNo—Azure CloudConnection UUID used.
kubernetes_connection_uuiduuidNo—Associated Kubernetes CloudConnection UUID.
resource_groupstringNo—Azure resource group.
locationstringNo—AKS region or zone.
cluster_namestringNo—Deleted cluster name.
forcebooleanNo—Allow delete even when pre-delete describe reports non-ready status.
timeout_secondsintegerNo—Provider operation wait timeout.
poll_intervalintegerNo—Provider operation poll interval.
workflow_run_uuidstringNo—Engine DAG run UUID for child step state.
retried_fromstringNo—Previous terminal state restored by engine retry.
retry_countintegerNo—Number of retry attempts recorded by the engine.
deletedbooleanNo—Whether the cluster was deleted or already absent.
existedbooleanNo—Whether the cluster existed before delete.
cluster_describejsonNo—Output from azure.aks.cluster.describe.
delete_clusterjsonNo—Output from azure.aks.cluster.delete.
wait_deletejsonNo—Output from azure.aks.operation.wait.
compensation_triggerjsonNo—DAG compensation trigger.
comp_current_layerjsonNo—Current compensation layer.
comp_queuejsonNo—Remaining compensation queue.
comp_retry_countjsonNo—Current compensation retry count.
failure_reasonstringNo—Engine failure reason.
failed_stepjsonNo—Failed DAG step.
failed_layerjsonNo—Failed DAG layer.
failed_at_statejsonNo—Failed state metadata.
errorstringNo—Error message.
error_typestringNo—Error class.
failure_typestringNo——
failed_actionstringNo——

DAG Layers ​

#LayerStepsCompensation
1preflightazure.aks.cluster.describe—
2deleteazure.aks.cluster.delete—
3waitazure.aks.operation.wait—

Execution Flow ​

Sub-workflows ​

Sub-workflowStep name
azure.aks.cluster.describecluster_describe
azure.aks.cluster.deletedelete_cluster
azure.aks.operation.waitwait_delete

API Usage ​

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

{
  "workflow_type": "cluster.delete-aks",
  "initial_data": {
    "azure_connection_uuid": "value",
    "resource_group": "value",
    "location": "value",
    "cluster_name": "value"
  }
}