Skip to content
Proud to collaborate with Microsoft for Startups

kubernetes.cluster.version ​

Read Kubernetes API server version.

Read the Kubernetes API server version through an existing CloudConnection.

Overview ​

PropertyValue
Workflow typeAtomic
LibraryApp-kubernetes
Version1.0

Input Schema ​

FieldTypeRequiredDefaultDescription
connection_uuiduuidYes—Kubernetes CloudConnection UUID.
organization_uuiduuidNo—Owning organization UUID (engine-injected).
workflow_run_idstringNo—Engine DAG run ID stamped onto child steps.

Output Schema ​

FieldTypeRequiredDefaultDescription
connection_uuiduuidNo—Kubernetes CloudConnection UUID.
organization_uuiduuidNo—Owning organization UUID (engine-injected).
server_versionstringNo—Kubernetes API server git version.
git_versionstringNo—Kubernetes API server git version.
majorstringNo—Kubernetes API server major version.
minorstringNo—Kubernetes API server minor version.
platformstringNo—Kubernetes API server platform.
checked_atstringNo—ISO timestamp when the version was read.
failure_reasonstringNo—Human-readable failure reason.
failed_stepjsonNo—Failed logical step.
failed_layerjsonNo—Failed logical layer.
failure_typestringNo—Failure category.
failed_actionstringNo—Action that failed.
failed_at_statestringNo—State where failure occurred.
errorstringNo—Error message.
error_typestringNo—Error class.
failed_atstringNo—ISO failure timestamp.

States ​

StateInitialTerminalSuccessAuto-advanceDescription
pendingYesNo—execute—
completedNoYesYes——
failedNoYesNo——

State Diagram ​

Transitions ​

FromActionToDescription
pendingexecutecompleted—
* (any state)failfailed—

API Usage ​

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

{
  "workflow_type": "kubernetes.cluster.version",
  "initial_data": {
    "connection_uuid": "value"
  }
}