×

规范

属性 类型 描述

apiVersion

字符串

APIVersion 定义此对象表示的版本化模式。服务器应将识别的模式转换为最新的内部值,并可能拒绝无法识别的值。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

容器

数组

所有容器的指标数据收集于同一时间窗口内。

containers[]

对象

ContainerMetrics 设置容器的资源使用指标。

kind

字符串

Kind 是一个字符串值,表示此对象所代表的 REST 资源。服务器可以从客户端提交请求的端点推断出这一点。不可更新。采用驼峰命名法。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta_v2

标准对象的元数据。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

时间戳

时间

以下字段定义了从时间区间 [Timestamp-Window, Timestamp] 收集指标的时间间隔。

窗口

持续时间

.containers

描述

所有容器的指标数据收集于同一时间窗口内。

类型

数组

.containers[]

描述

ContainerMetrics 设置容器的资源使用指标。

类型

对象

必需
  • 名称

  • 使用情况

属性 类型 描述

名称

字符串

与 pod.spec.containers 中的容器名称相对应。

使用情况

对象 (数量)

内存使用量即内存工作集。

API 端点

以下 API 端点可用

  • /apis/metrics.k8s.io/v1beta1/pods

    • GET:列出 PodMetrics 类型的对象

  • /apis/metrics.k8s.io/v1beta1/namespaces/{namespace}/pods

    • GET:列出 PodMetrics 类型的对象

  • /apis/metrics.k8s.io/v1beta1/namespaces/{namespace}/pods/{name}

    • GET:读取指定的 PodMetrics

/apis/metrics.k8s.io/v1beta1/pods

HTTP 方法

GET

描述

列出 PodMetrics 类型的对象

表 1. HTTP 响应
HTTP 代码 响应体

200 - OK

PodMetricsList 模式

/apis/metrics.k8s.io/v1beta1/namespaces/{namespace}/pods

HTTP 方法

GET

描述

列出 PodMetrics 类型的对象

表 2. HTTP 响应
HTTP 代码 响应体

200 - OK

PodMetricsList 模式

/apis/metrics.k8s.io/v1beta1/namespaces/{namespace}/pods/{name}

表 3. 全局路径参数
参数 类型 描述

名称

字符串

PodMetrics 的名称

HTTP 方法

GET

描述

读取指定的 PodMetrics

表 4. HTTP 响应
HTTP 代码 响应体

200 - OK

PodMetrics 模式