Kubernetes v1.37 已将 metrics.k8s.io API 晋升为稳定的 v1 版本。该 API 为节点和 Pod 提供关键的 CPU 和内存使用数据，支撑着 kubectl top 以及基于资源指标的水平自动扩缩容等关键功能。对于集群操作人员和开发人员而言，此次晋升标志着该 API 具有保证的稳定性。v1 API 保留了与其前身 v1beta1 相同的资源类型和字段。该资源指标 API 自 v1.6 作为 alpha 版本引入，在 v1.8 中晋升为 beta 版本，并已在生产环境中可靠使用多年。该 API 暴露 NodeMetrics 以提供节点资源使用情况，以及 PodMetrics 以提供 Pod 资源使用情况（包括按容器细分的数据）。该 API 仅提供自动扩缩容和基本检查所需的指标，而非完整的监控解决方案。v1 API 的接口表面与 v1beta1 完全相同，仅 API 版本本身除外。虽然 kubectl top 支持这两个版本并优先使用 v1，但水平 Pod 自动扩缩容控制器目前仅支持 v1beta1。无需启用任何特性门控，因为该 API 通过 metrics-server 等实现提供的 API 聚合进行服务。要使 v1 可用，实现必须提供该版本并注册关联的 APIService。在此过渡期间，为实现向后兼容，实现应继续同时提供 v1 和 v1beta1。