HorizontalPodAutoscaler

水平 Pod 自动伸缩器的配置。

apiVersion: autoscaling/v1

import "k8s.io/api/autoscaling/v1"

HorizontalPodAutoscaler

水平 Pod 自动伸缩器的配置。


HorizontalPodAutoscalerSpec

水平 Pod 自动伸缩器的规范。


  • maxReplicas (int32), 必需

    maxReplicas 是自动伸缩器可以设置的 Pod 数量上限;不能小于 MinReplicas。

  • scaleTargetRef (CrossVersionObjectReference), 必需

    对缩放资源的引用;水平 Pod 自动伸缩器将学习当前的资源消耗,并使用其 Scale 子资源设置所需的 Pod 数量。

    CrossVersionObjectReference 包含足够的信息来识别引用的资源。

  • minReplicas (int32)

    minReplicas 是自动伸缩器可以缩减到的副本数量的下限。默认值为 1 个 Pod。如果启用了 alpha 特性门控 HPAScaleToZero 并且配置了至少一个 Object 或 External 指标,则允许 minReplicas 为 0。只要至少有一个指标值可用,伸缩就处于活动状态。

  • targetCPUUtilizationPercentage (int32)

    targetCPUUtilizationPercentage 是所有 Pod 上的目标平均 CPU 利用率(表示为请求 CPU 的百分比);如果未指定,将使用默认自动伸缩策略。

HorizontalPodAutoscalerStatus

水平 Pod 自动伸缩器的当前状态


  • currentReplicas (int32), 必需

    currentReplicas 是此自动伸缩器管理的 Pod 的当前副本数量。

  • desiredReplicas (int32), 必需

    desiredReplicas 是此自动伸缩器管理的 Pod 的所需副本数量。

  • currentCPUUtilizationPercentage (int32)

    currentCPUUtilizationPercentage 是所有 Pod 上的当前平均 CPU 利用率,表示为请求 CPU 的百分比,例如 70 表示平均 Pod 正在使用其请求 CPU 的 70%。

  • lastScaleTime (Time)

    lastScaleTime 是水平 Pod 自动伸缩器缩放 Pod 数量的最后时间;自动伸缩器使用它来控制更改 Pod 数量的频率。

    Time 是 time.Time 的包装器,支持正确地编组到 YAML 和 JSON。为时间包提供的许多工厂方法提供包装器。

  • observedGeneration (int64)

    observedGeneration 是此自动伸缩器观察到的最新生成代。

HorizontalPodAutoscalerList

水平 Pod 自动伸缩器对象的列表。


  • apiVersion: autoscaling/v1

  • kind: HorizontalPodAutoscalerList

  • metadata (ListMeta)

    标准列表元数据。

  • items ([]HorizontalPodAutoscaler), 必需

    items 是水平 Pod 自动伸缩器对象的列表。

操作


get 读取指定的 HorizontalPodAutoscaler

HTTP 请求

GET /apis/autoscaling/v1/namespaces/{namespace}/horizontalpodautoscalers/{name}

Parameters

  • name (在路径中): string, 必需

    HorizontalPodAutoscaler 的名称

  • namespace (在路径中): string, 必需

    命名空间

  • pretty (在查询中): string

    pretty

响应

200 (HorizontalPodAutoscaler): 确定

401: 未授权

get 读取指定 HorizontalPodAutoscaler 的状态

HTTP 请求

GET /apis/autoscaling/v1/namespaces/{namespace}/horizontalpodautoscalers/{name}/status

Parameters

  • name (在路径中): string, 必需

    HorizontalPodAutoscaler 的名称

  • namespace (在路径中): string, 必需

    命名空间

  • pretty (在查询中): string

    pretty

响应

200 (HorizontalPodAutoscaler): 确定

401: 未授权

list 列出或监视 HorizontalPodAutoscaler 类型的对象

HTTP 请求

GET /apis/autoscaling/v1/namespaces/{namespace}/horizontalpodautoscalers

Parameters

响应

200 (HorizontalPodAutoscalerList): 确定

401: 未授权

list 列出或监视 HorizontalPodAutoscaler 类型的对象

HTTP 请求

GET /apis/autoscaling/v1/horizontalpodautoscalers

Parameters

响应

200 (HorizontalPodAutoscalerList): 确定

401: 未授权

create 创建 HorizontalPodAutoscaler

HTTP 请求

POST /apis/autoscaling/v1/namespaces/{namespace}/horizontalpodautoscalers

Parameters

响应

200 (HorizontalPodAutoscaler): 确定

201 (HorizontalPodAutoscaler): 已创建

202 (HorizontalPodAutoscaler): 已接受

401: 未授权

update 替换指定的 HorizontalPodAutoscaler

HTTP 请求

PUT /apis/autoscaling/v1/namespaces/{namespace}/horizontalpodautoscalers/{name}

Parameters

响应

200 (HorizontalPodAutoscaler): 确定

201 (HorizontalPodAutoscaler): 已创建

401: 未授权

update 替换指定 HorizontalPodAutoscaler 的状态

HTTP 请求

PUT /apis/autoscaling/v1/namespaces/{namespace}/horizontalpodautoscalers/{name}/status

Parameters

响应

200 (HorizontalPodAutoscaler): 确定

201 (HorizontalPodAutoscaler): 已创建

401: 未授权

patch 部分更新指定的 HorizontalPodAutoscaler

HTTP 请求

PATCH /apis/autoscaling/v1/namespaces/{namespace}/horizontalpodautoscalers/{name}

Parameters

  • name (在路径中): string, 必需

    HorizontalPodAutoscaler 的名称

  • namespace (在路径中): string, 必需

    命名空间

  • body: Patch, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (in query): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (HorizontalPodAutoscaler): 确定

201 (HorizontalPodAutoscaler): 已创建

401: 未授权

patch 部分更新指定 HorizontalPodAutoscaler 的状态

HTTP 请求

PATCH /apis/autoscaling/v1/namespaces/{namespace}/horizontalpodautoscalers/{name}/status

Parameters

  • name (在路径中): string, 必需

    HorizontalPodAutoscaler 的名称

  • namespace (在路径中): string, 必需

    命名空间

  • body: Patch, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (in query): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (HorizontalPodAutoscaler): 确定

201 (HorizontalPodAutoscaler): 已创建

401: 未授权

delete 删除 HorizontalPodAutoscaler

HTTP 请求

DELETE /apis/autoscaling/v1/namespaces/{namespace}/horizontalpodautoscalers/{name}

Parameters

响应

200 (Status): 确定

202 (Status): 已接受

401: 未授权

deletecollection 删除 HorizontalPodAutoscaler 集合

HTTP 请求

DELETE /apis/autoscaling/v1/namespaces/{namespace}/horizontalpodautoscalers

Parameters

响应

200 (Status): 确定

401: 未授权

本页面是自动生成的。

如果您打算报告此页面的问题,请在您的问题描述中提及该页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。

上次修改时间:2025 年 4 月 9 日下午 6:36 PST:更新 v1.32 的 API 参考文档 (a3b579d035)