Skip to main content
API Explorer|API Explorer
Monitoring & Collection/Zaku
GETZakuSince 1.0SynchronousAuth Required

GetCluster

Retrieve a single Kubernetes cluster by its UUID

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Path Parameters

Request Inputs

Path Parameters

  • uuidStringRequired

    UUID of the cluster to retrieve

Responses

200 OK

On success, this API returns the following response structure.

  • uuidString

    Unique identifier of the cluster

    Example: cluster-abc123

  • platformIdString

    Platform ID this cluster belongs to

    Example: plat-001

  • zakuIdString

    Internal Zaku numeric identifier

    Example: 42

  • nameString

    Human-readable cluster name

    Example: prod-k8s-cluster-01

  • statusString

    Current operational status of the cluster

    Example: Running

  • descriptionString

    Optional description of the cluster

    Example: Production Kubernetes cluster for AI workloads

  • nodeCountInteger

    Total number of nodes in this cluster

    Example: 12

  • createDateString

    Timestamp when the cluster was registered

    Example: 2026-01-15T08:00:00Z

  • lastSyncAtString

    Timestamp of the last successful sync

    Example: 2026-01-15T08:00:00Z

  • syncStatusString

    Status of the last synchronization attempt

    Example: Success

  • lastSyncErrorString

    Error message from the last failed sync, if any

    Example: connection refused

  • syncDurationMsString

    Duration of the last sync operation in milliseconds

    Example: 350

Endpoint

GET/api/v1/zaku/clusters/{uuid}

/api/v1/zaku/clusters/{uuid}

Operation ID

GetCluster

Permalink

Request Example

curl -X GET '{host}/api/v1/zaku/clusters/{uuid}' -H 'Authorization: Bearer {token}'

Response Example

200
{
  "uuid": "cluster-abc123",
  "platformId": "plat-001",
  "zakuId": 42,
  "name": "prod-k8s-cluster-01",
  "status": "Running",
  "description": "Production Kubernetes cluster for AI workloads",
  "nodeCount": 12,
  "createDate": "example"
}

Change History

This API has no change history records yet.

View all change history