---
title: "获取K8s集群详细信息"
method: GET
path: "/api/v1/k8s/cluster/{id}/detail"
tags: ["K8s集群管理"]
---

# 获取K8s集群详细信息

`GET /api/v1/k8s/cluster/{id}/detail`

获取集群的完整详细信息，包括节点、工作负载、组件、网络配置、监控信息等

## Path parameters

- `id` integer, required

## Response `200`

获取成功

- object
  - `code` integer — 状态码
  - `data` object — 返回的数据
    - `cluster` ModelKubeCluster
      - `clusterType` integer
      - `createdAt` string
      - `credential` string
      - `description` string
      - `id` integer
      - `lastSyncAt` string
      - `masterNodes` integer
      - `name` string
      - `nodeCount` integer
      - `readyNodes` integer
      - `status` integer
      - `updatedAt` string
      - `version` string
      - `workerNodes` integer
    - `components` ModelComponentInfo[] — 安装的组件
      - `name` string — 组件名称
      - `namespace` string — 命名空间
      - `status` string — 状态
      - `type` string — 组件类型 (system/addon)
      - `version` string — 版本
    - `events` ModelClusterEvent[] — 集群事件
      - `count` integer — 发生次数
      - `firstTime` string — 首次时间
      - `involvedObject` string — 相关对象
      - `lastTime` string — 最后时间
      - `message` string — 消息
      - `reason` string — 原因
      - `source` string — 事件源
      - `type` string — 事件类型
    - `monitoring` ModelMonitoringInfo
      - `cpu` ModelClusterResourceMetrics
        - `available` string — 可用量
        - `requestRate` number — 请求率 (0-100)
        - `total` string — 总量
        - `usageRate` number — 使用率 (0-100)
        - `used` string — 已使用
      - `memory` ModelClusterResourceMetrics
        - `available` string — 可用量
        - `requestRate` number — 请求率 (0-100)
        - `total` string — 总量
        - `usageRate` number — 使用率 (0-100)
        - `used` string — 已使用
      - `network` ModelNetworkMetrics
        - `inboundTraffic` string — 入站流量
        - `outboundTraffic` string — 出站流量
        - `packetsIn` integer — 入站包数
        - `packetsOut` integer — 出站包数
      - `storage` ModelStorageMetrics
        - `boundPVs` integer — 已绑定PV数
        - `storageClasses` string[] — 存储类列表
        - `totalPVCs` integer — PVC总数
        - `totalPVs` integer — PV总数
    - `network` ModelNetworkInfo
      - `apiServerEndpoint` string — API Server内网端点
      - `dnsService` string — DNS服务
      - `networkPlugin` string — 网络插件
      - `podCIDR` string — Pod CIDR
      - `proxyMode` string — 服务转发模式
      - `serviceCIDR` string — Service CIDR
    - `nodes` ModelNodeInfo[]
      - `allocatable` object — 可分配资源
      - `capacity` object — CPU、内存等资源容量
      - `conditions` ModelNodeCondition[] — 节点状态条件
        - `reason` string
        - `status` string
        - `type` string
      - `externalIP` string
      - `internalIP` string
      - `name` string
      - `os` string
      - `role` string — master/worker/etcd
      - `status` string — Ready/NotReady
      - `version` string
    - `runtime` ModelRuntimeSummary
      - `apiServerVersion` string — API Server版本
      - `containerRuntime` string — 容器运行时
      - `coreDNSVersion` string — CoreDNS版本
      - `etcdVersion` string — etcd版本
      - `kubeProxyVersion` string — kube-proxy版本
      - `kubernetesVersion` string — Kubernetes版本
      - `upTime` string — 集群运行时间
    - `summary` ModelClusterSummary
      - `masterNodes` integer
      - `readyNodes` integer
      - `totalNodes` integer
      - `workerNodes` integer
    - `workloads` ModelWorkloadSummary
      - `runningPods` integer — 运行中的Pod数
      - `totalCronJobs` integer — CronJob总数
      - `totalDaemonSets` integer — DaemonSet总数
      - `totalDeployments` integer — Deployment总数
      - `totalJobs` integer — Job总数
      - `totalPods` integer — Pod总数
      - `totalStatefulSets` integer — StatefulSet总数
  - `message` string — 提示信息

## Other responses

- `400` — 参数错误
- `404` — 集群不存在
- `500` — 服务器错误

---

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