data.cluster.provider-config-specs

Return provider/cluster-kind configuration schemas for the cluster provisioning UI and callers.

Return provider/cluster-kind configuration schemas for cluster provisioning.

Overview

Property	Value
Workflow type	Atomic
Library	App-clusters
Version	1.0

Input Schema

Field	Type	Required	Default	Description
provider	string	No	—	Optional provider filter: aws, gcp, or magalucloud.
cluster_kind	string	No	—	Optional cluster kind filter: eks, gke, aws-vm, gcp-vm, or mgc-kubernetes.
include_defaults	boolean	No	—	Include default values for optional fields.

Output Schema

Field	Type	Required	Default	Description
specs	json	No	—	Provider config schema entries keyed by provider and cluster kind.
count	integer	No	—	Number of spec entries returned.
generated_at	string	No	—	ISO timestamp when metadata was generated.
failure_reason	string	No	—	Human-readable failure reason.
failed_step	string	No	—	Failed logical step.
failed_layer	json	No	—	Engine failed layer when applicable.
failed_at_state	string	No	—	State where failure occurred.
error	string	No	—	Error message.
error_type	string	No	—	Error class.

States

State	Initial	Terminal	Success	Auto-advance	Description
done	Yes	Yes	Yes	—	—

API Usage

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

{
  "workflow_type": "data.cluster.provider-config-specs",
  "initial_data": {
    "provider": "value",
    "cluster_kind": "value",
    "include_defaults": true
  }
}