STstreamkap
Agents

Get Agent Cluster

Changed on

Return cluster-level Flink info for the agent runtime - slots + version.

Reports total and available task slots, TaskManager count, and the Flink version of the tenant's Flink cluster.

Agents and transforms share the same tenant Flink cluster, so this endpoint accepts either read:agents or read:transforms.

When the tenant has no Flink cluster provisioned, the response is HTTP 200 with available=false and zeroed fields rather than an error, so a client can show a "cluster not available" note.

get/agents/cluster

Request

Response

Successful Response

availableboolean

False when the tenant's Flink cluster is not provisioned or unreachable; other fields are zeroed.

taskmanagersinteger

Registered TaskManagers

slotsTotalinteger

Total task slots across all TaskManagers

slotsAvailableinteger

Idle task slots available for new deployments

flinkVersionstring

Flink runtime version

Changes