---
title: "Query Execution Cluster"
method: GET
path: "/execution/clusters/workspace/{workspace_id}"
tags: ["ExecutionCluster"]
---

# Query Execution Cluster

`GET /execution/clusters/workspace/{workspace_id}`

Query Execution Clusters, sorted last updated time descending

## Path parameters

- `workspace_id` string, required

## Query parameters

- `type` 'cloud_function' | 'managed_host' | 'vms' | 'kubernetes', required — type of execution cluster
- `operating_system` 'windows' | 'linux' | 'osx', required — Operation system used in the runtime
- `limit` integer
- `cursor` string

## Response `200`

Execution Host

- ExecutionClusterQueryResult — Common paginated response result holder
  - `count` integer, required — Number of items returned in this response, maybe 0 if count == limit on last call
  - `limit` integer — Limit applied to this query
  - `cursor` string — Cursor that can be used to fetch the next page, count <= limit
  - `items` ExecutionCluster[] — Results
    - `labels` string[] — Cluster labels
    - `name` string, required — name of the cluster
    - `os` 'windows' | 'linux' | 'osx' — Operation system used in the runtime
    - `provider` 'google_cloud' | 'amazon_web_services' | 'customer', required — Cloud where execution host resides
    - `region` string — region the execution cluster is in
    - `cluster_type` 'cloud_function' | 'managed_host' | 'vms' | 'kubernetes' — type of execution cluster
    - `target_state` ExecutionClusterState — Execution cluster state
      - `instance_type` string — Unique identifies for the instance type (e.g. mac1.metal)
      - `size` integer — Size of the cluster
      - `node_state` ExecutionNodeState — Execution node state
        - `versions` object — Map of software versions running on the cluster
        - `lastUpdatedTime` integer
    - `update_config` ExecutionClusterUpdateConfig — Configuration for updating execution cluster
      - `max_unavailable` integer — Maximum number of nodes that can be unavailable at once during updates
    - `workspace_id` string, required — Id of workspace this host is assigned to or 'mabl' for general purpose
    - `zones` string[] — zones the execution cluster is in
    - `current_state` ExecutionClusterState — Execution cluster state
      - `instance_type` string — Unique identifies for the instance type (e.g. mac1.metal)
      - `size` integer — Size of the cluster
      - `node_state` ExecutionNodeState — Execution node state
        - `versions` object — Map of software versions running on the cluster
        - `lastUpdatedTime` integer
    - `id` string, required — API generated globally unique ID
    - `etag` string — API version etag
    - `created_time` integer, required — Creation time, epoch millis
    - `created_by_id` string, required — Creation principal ID
    - `last_updated_time` integer, required — Last updated time, epoch millis
    - `last_updated_by_id` string, required — Last updating principal ID
    - `deleted_time` integer — Deletion time, epoch millis
    - `deleted_by_id` string — Deletion principal ID

## Other responses

- `401` — Missing or invalid credentials
- `403` — Actor is not authorized to make this call
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)