v1

latestSwagger 2.02026-07-172964242.9 KB
Cluster

Get cluster

Returns information about the cluster.

get/v1/cluster

Response

OK response.

idstring required

Unique identifier for the cluster.

Example response

{
  "hosts": [
    {
      "client_addresses": [
        "10.24.34.2",
        "i-0123456789abcdef.ec2.internal"
      ],
      "cohort": {
        "cohort_id": "zdjfu3tfxg1cihv3146ro3hy2",
        "control_available": true,
        "member_id": "lah4bsznw6kc0hp7biylmmmll",
        "type": "swarm"
      },
      "cpus": 16,
      "data_dir": "/data",
      "default_pgedge_version": {
        "postgres_version": "17.6",
        "spock_version": "5"
      },
      "etcd_mode": "server",
      "id": "us-east-1",
      "memory": "16GB",
      "orchestrator": "swarm",
      "peer_addresses": [
        "10.24.34.2",
        "i-0123456789abcdef.ec2.internal"
      ],
      "status": {
        "components": {},
        "state": "healthy",
        "updated_at": "2025-06-17T00:00:00Z"
      },
      "supported_pgedge_versions": [
        {
          "postgres_version": "17.6",
          "spock_version": "5"
        },
        {
          "postgres_version": "18.1",
          "spock_version": "5"
        },
        {
          "postgres_version": "16.10",
          "spock_version": "5"
        }
      ]
    },
    {
      "client_addresses": [
        "10.24.35.2",
        "i-058731542fee493f.ec2.internal"
      ],
      "cohort": {
        "cohort_id": "zdjfu3tfxg1cihv3146ro3hy2",
        "control_available": true,
        "member_id": "cb88u9jael2psnepep5iuzb4r",
        "type": "swarm"
      },
      "cpus": 16,
      "data_dir": "/data",
      "default_pgedge_version": {
        "postgres_version": "17.6",
        "spock_version": "5"
      },
      "etcd_mode": "server",
      "id": "ap-south-1",
      "memory": "16GB",
      "orchestrator": "swarm",
      "peer_addresses": [
        "10.24.35.2",
        "i-058731542fee493f.ec2.internal"
      ],
      "status": {
        "components": {},
        "state": "healthy",
        "updated_at": "2025-06-17T00:00:00Z"
      },
      "supported_pgedge_versions": [
        {
          "postgres_version": "17.6",
          "spock_version": "5"
        },
        {
          "postgres_version": "18.1",
          "spock_version": "5"
        },
        {
          "postgres_version": "16.10",
          "spock_version": "5"
        }
      ]
    },
    {
      "client_addresses": [
        "10.24.36.2",
        "i-494027b7b53f6a23.ec2.internal"
      ],
      "cohort": {
        "cohort_id": "zdjfu3tfxg1cihv3146ro3hy2",
        "control_available": true,
        "member_id": "u7u9i3nhqunxc4wj577l6ecb0",
        "type": "swarm"
      },
      "cpus": 16,
      "data_dir": "/data",
      "default_pgedge_version": {
        "postgres_version": "17.6",
        "spock_version": "5"
      },
      "etcd_mode": "client",
      "id": "eu-central-1",
      "memory": "16GB",
      "orchestrator": "swarm",
      "peer_addresses": [
        "10.24.36.2",
        "i-494027b7b53f6a23.ec2.internal"
      ],
      "status": {
        "components": {},
        "state": "healthy",
        "updated_at": "2025-06-17T00:00:00Z"
      },
      "supported_pgedge_versions": [
        {
          "postgres_version": "17.6",
          "spock_version": "5"
        },
        {
          "postgres_version": "18.1",
          "spock_version": "5"
        },
        {
          "postgres_version": "16.10",
          "spock_version": "5"
        }
      ]
    }
  ],
  "id": "76f9b8c0-4958-11f0-a489-3bb29577c696",
  "status": {
    "state": "available"
  }
}
All 29 operations