Clusters

Edit online
Summary
Get a list of provisioned clusters for your organization, the date each cluster was provisioned, and a timestamp for the first and last date Cloudability received data for each cluster. End point 
 /containers/clusters

Query Arguments

Parameter Description Default Allowed
start/end Start/End date for the window of cluster results. Affects the nodes returned (only nodes visible in this window appear in the results). Required Format YYYY-MM-DD
pretty Pretty-print the JSON response. None true
Example Request 
curl "https://api.usgov.cloudability.com/v3/containers/v2/clusters?pretty=true&start=2025-08-01&end=2025-08-05" \
-H "apptio-opentoken: ${token}" \
-H "apptio-environmentid: ${env_id}"
Sample Response 
{
    "result": {
        "clusters": [
            {
                "id": "c5fb087c-800d-44b4-aeb6-3aed71050690",
                "name": "test-cluster",
                "lastSeen": "2025-08-07T18:00:00Z",
                "nodes": [],
                "firstSeen": "2025-03-07T02:00:11.412119Z",
                "provisionedAt": "2025-03-06T23:15:24.124553Z",
                "vendor": "aws",
                "clusterType": "eks",
                "vendorAccountIdentifier": "123456789"
            }
        ],
        "meta": {
            "orgHasProvisioned": true,
            "orgHasData": true,
            "firstSeenDate": "2024-10-08T18:01:03.707223Z"
        }
    }
}