Pular para o conteúdo principal
GET
/
clusters
/
{name}
Get Cluster
curl --request GET \
  --url http://{host}:{port}/{basePath}/clusters/{name} \
  --header 'Authorization: <api-key>'
{
  "apiVersion": "v1",
  "kind": "ClusterRegistration",
  "metadata": {
    "name": "production-us-east-1",
    "namespace": "chatcli-system",
    "createdAt": "2026-01-15T10:00:00Z"
  },
  "spec": {
    "displayName": "Production US East 1",
    "kubeconfigSecret": "cluster-prod-us-east-1-kubeconfig",
    "tier": "production",
    "region": "us-east-1"
  },
  "status": {
    "phase": "Connected",
    "lastHealthCheck": "2026-03-19T15:00:00Z",
    "kubernetesVersion": "v1.31.2",
    "nodeCount": 12,
    "namespaceCount": 25,
    "activeIssues": 2,
    "activeRemediations": 1,
    "resourceUsage": {
      "cpuCapacity": "48",
      "cpuUsed": "31.2",
      "memoryCapacity": "192Gi",
      "memoryUsed": "124Gi"
    }
  }
}
​
name
string
obrigatório
Nome único de registro do cluster
​
namespace
string
padrão:"default"
Namespace do Kubernetes onde o CR ClusterRegistration reside
{
  "apiVersion": "v1",
  "kind": "ClusterRegistration",
  "metadata": {
    "name": "production-us-east-1",
    "namespace": "chatcli-system",
    "createdAt": "2026-01-15T10:00:00Z"
  },
  "spec": {
    "displayName": "Production US East 1",
    "kubeconfigSecret": "cluster-prod-us-east-1-kubeconfig",
    "tier": "production",
    "region": "us-east-1"
  },
  "status": {
    "phase": "Connected",
    "lastHealthCheck": "2026-03-19T15:00:00Z",
    "kubernetesVersion": "v1.31.2",
    "nodeCount": 12,
    "namespaceCount": 25,
    "activeIssues": 2,
    "activeRemediations": 1,
    "resourceUsage": {
      "cpuCapacity": "48",
      "cpuUsed": "31.2",
      "memoryCapacity": "192Gi",
      "memoryUsed": "124Gi"
    }
  }
}

{
  "apiVersion": "v1",
  "kind": "Error",
  "error": {
    "code": 404,
    "message": "Cluster not found",
    "details": "No cluster registration named 'production-us-east-1' found"
  }
}

Autorizações

​
Authorization
string
header
obrigatório

Bearer token issued by the operator. Format: Authorization: Bearer <token>.

Parâmetros de caminho

​
name
string
obrigatório

Unique registration name of the cluster.

Exemplo:

"production-us-east-1"

Parâmetros de consulta

​
namespace
string
padrão:default

Kubernetes namespace where the ClusterRegistration CR resides.

Resposta

Cluster found

​
apiVersion
string
obrigatório
Exemplo:

"v1"

​
kind
string
obrigatório
Exemplo:

"ClusterRegistration"

​
metadata
object
obrigatório
​
spec
object
obrigatório
​
status
object