GET
/
cloud
/
v2
/
k8s
/
clusters
/
{project_id}
/
{region_id}
curl --request GET \
  --url https://api.gcore.com/cloud/v2/k8s/clusters/{project_id}/{region_id} \
  --header 'APIKey: <api-key>'
{
  "count": 1,
  "results": [
    {
      "authentication": {
        "kubeconfig_created_at": "2024-02-15T11:53:03Z",
        "kubeconfig_expires_at": "2026-02-15T11:53:03Z",
        "oidc": {
          "client_id": "kubernetes",
          "groups_claim": "groups",
          "groups_prefix": "oidc:",
          "issuer_url": "https://accounts.provider.example",
          "required_claims": {
            "claim": "value"
          },
          "signing_algs": [
            "RS256",
            "RS512"
          ],
          "username_claim": "sub",
          "username_prefix": "oidc:"
        }
      },
      "autoscaler_config": {
        "scale-down-unneeded-time": "5m"
      },
      "cni": {
        "cilium": {
          "encryption": false,
          "hubble_relay": false,
          "hubble_ui": false,
          "lb_acceleration": false,
          "lb_mode": "hybrid",
          "mask_size": 24,
          "mask_size_v6": 120,
          "routing_mode": "tunnel",
          "tunnel": "geneve"
        },
        "provider": "calico"
      },
      "created_at": "2023-02-15T11:53:03Z",
      "creator_task_id": "1772de21-f013-4b70-9f8f-a518985b3bc2",
      "ddos_profile": {
        "enabled": true,
        "fields": [
          {
            "base_field": 10,
            "field_value": [
              45046,
              45047
            ]
          }
        ],
        "profile_template": 29
      },
      "fixed_network": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "fixed_subnet": "90729bc3-dd37-4761-ae09-b32f2f0a365b",
      "id": "f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1",
      "is_ipv6": true,
      "is_public": false,
      "keypair": "mykeypair",
      "logging": {
        "destination_region_id": 1,
        "enabled": true,
        "retention_policy": {
          "period": 45
        },
        "topic_name": "my-log-name"
      },
      "name": "test k8s",
      "pods_ip_pool": "172.16.0.0/18",
      "pods_ipv6_pool": "2a03:90c0:88:393::/64",
      "pools": [
        {
          "auto_healing_enabled": true,
          "boot_volume_size": 50,
          "boot_volume_type": "ssd_hiiops",
          "created_at": "2023-02-15T11:53:03+03:00",
          "crio_config": {
            "default-ulimits": "nofile=1024:2048"
          },
          "flavor_id": "g1-standard-1-2",
          "id": "f01fd9a0-9548-48ba-82dc-a8c8b2d6f2f1",
          "is_public_ipv4": true,
          "kubelet_config": {
            "podMaxPids": "4096"
          },
          "labels": {
            "my-label": "foo"
          },
          "max_node_count": 10,
          "min_node_count": 1,
          "name": "test",
          "node_count": 2,
          "servergroup_id": "1772de21-f013-4b70-9f8f-a518985b3bc2",
          "servergroup_name": "my-server-group",
          "servergroup_policy": "anti-affinity",
          "status": "Running",
          "taints": {
            "my-taint": "bar:NoSchedule"
          }
        }
      ],
      "services_ip_pool": "172.24.0.0/18",
      "services_ipv6_pool": "2a03:90c0:88:381::/108",
      "status": "Provisioned",
      "task_id": null,
      "version": "v1.28.1"
    }
  ]
}

Authorizations

APIKey
string
header
required

API key for authentication.

Path Parameters

project_id
integer
required

Project identifier

region_id
integer
required

Region identifier

Response

200 - application/json

cluster list

The response is of type object.