cluster.status-gke

Describe GKE provider status and optionally verify Kubernetes access.

Overview

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

Input Schema

Field	Type	Required	Default	Description
organization_uuid	uuid	No	—	Organization UUID for tenant/audit context.
gcp_connection_uuid	uuid	Yes	—	GCP CloudConnection UUID used for provider API calls.
kubernetes_connection_uuid	uuid	No	—	Registered Kubernetes CloudConnection UUID to verify.
project_id	string	Yes	—	GCP project ID.
location	string	Yes	—	GKE region or zone.
cluster_name	string	Yes	—	GKE cluster name.
include_kubernetes_verify	boolean	No	—	Run common Kubernetes connection verification when a connection UUID is supplied.
include_snapshot	boolean	No	—	Ask common verify to include a lightweight cluster snapshot when supported.

Output Schema

Field	Type	Required	Default	Description
organization_uuid	uuid	No	—	Echoed organization UUID.
gcp_connection_uuid	uuid	No	—	GCP CloudConnection UUID used.
kubernetes_connection_uuid	uuid	No	—	Kubernetes CloudConnection UUID checked.
project_id	string	No	—	GCP project ID.
location	string	No	—	GKE region or zone.
cluster_name	string	No	—	GKE cluster name.
include_kubernetes_verify	boolean	No	—	Run common Kubernetes connection verification when a connection UUID is supplied.
include_snapshot	boolean	No	—	Ask common verify to include a lightweight cluster snapshot when supported.
workflow_run_uuid	string	No	—	Engine DAG run UUID for child step state.
retried_from	string	No	—	Previous terminal state restored by engine retry.
retry_count	integer	No	—	Number of retry attempts recorded by the engine.
status	string	No	—	Provider cluster status.
endpoint	string	No	—	Kubernetes API endpoint.
kubernetes_version	string	No	—	Current control-plane version.
node_pools	json	No	—	Provider node-pool summary.
conditions	json	No	—	Provider cluster conditions.
cluster_describe	json	No	—	Output from gcp.gke.cluster.describe.
verify_connection	json	No	—	Output from cluster.verify-kubernetes-connection.
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.
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.

DAG Layers

#	Layer	Steps	Compensation
1	describe	gcp.gke.cluster.describe	—
2	verify	cluster.verify-kubernetes-connection	—

Execution Flow

Sub-workflows

Sub-workflow	Step name
gcp.gke.cluster.describe	cluster_describe
cluster.verify-kubernetes-connection	verify_connection

API Usage

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

{
  "workflow_type": "cluster.status-gke",
  "initial_data": {
    "gcp_connection_uuid": "value",
    "project_id": "value",
    "location": "value",
    "cluster_name": "value"
  }
}