ReplicaSet

ReplicaSet 确保在任何给定时间都有指定数量的 Pod 副本在运行。

apiVersion: apps/v1

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

ReplicaSet

ReplicaSet 确保在任何给定时间都有指定数量的 Pod 副本在运行。


ReplicaSetSpec

ReplicaSetSpec 是 ReplicaSet 的规范。


ReplicaSetStatus

ReplicaSetStatus 表示 ReplicaSet 的当前状态。


  • replicas (int32), required

    Replicas 是最近观察到的非终止 Pod 的数量。更多信息:https://kubernetes.ac.cn/docs/concepts/workloads/controllers/replicaset

  • availableReplicas (int32)

    此 ReplicaSet 中处于可用状态的非终止 Pod 数量(至少就绪了 minReadySeconds 秒)。

  • readyReplicas (int32)

    此 ReplicaSet 目标中具有 Ready 状态的非终止 Pod 数量。

  • terminatingReplicas (int32)

    此副本集的终止中的 Pod 数量。处于终止中的 Pod 具有非 null 的 .metadata.deletionTimestamp,且尚未达到 Failed 或 Succeeded 的 .status.phase 阶段。

    这是一个 Beta 字段,需要启用 DeploymentReplicaSetTerminatingReplicas 功能(默认启用)。

  • fullyLabeledReplicas (int32)

    标签与副本集 Pod 模板标签匹配的非终止 Pod 数量。

  • conditions ([]ReplicaSetCondition)

    Patch 策略:在键 type 上合并

    映射:在合并期间将保留键类型上的唯一值

    表示关于副本集当前状态的最新可用观察结果。

    ReplicaSetCondition 描述了副本集在某个时间点的状态。

    • conditions.status (string), required

      条件的状态,为 True、False 或 Unknown 之一。

    • conditions.type (string), required

      副本集条件类型。

    • conditions.lastTransitionTime (Time)

      条件从一种状态转换到另一种状态的最后一次时间。

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

    • conditions.message (string)

      指示过渡细节的人类可读消息。

    • conditions.reason (string)

      条件最后一次过渡的原因。

  • observedGeneration (int64)

    ObservedGeneration 反映了最近观察到的 ReplicaSet 的生成版本。

ReplicaSetList

ReplicaSetList 是 ReplicaSet 的集合。


操作


get 读取指定的 ReplicaSet

HTTP 请求

GET /apis/apps/v1/namespaces/{namespace}/replicasets/{name}

Parameters

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

    ReplicaSet 的名称

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

    命名空间

  • pretty (在查询中): string

    pretty

响应

200 (ReplicaSet): OK

401: 未授权

get 读取指定 ReplicaSet 的状态

HTTP 请求

GET /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status

Parameters

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

    ReplicaSet 的名称

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

    命名空间

  • pretty (在查询中): string

    pretty

响应

200 (ReplicaSet): OK

401: 未授权

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

HTTP 请求

GET /apis/apps/v1/namespaces/{namespace}/replicasets

Parameters

响应

200 (ReplicaSetList): OK

401: 未授权

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

HTTP 请求

GET /apis/apps/v1/replicasets

Parameters

响应

200 (ReplicaSetList): OK

401: 未授权

create 创建一个 ReplicaSet

HTTP 请求

POST /apis/apps/v1/namespaces/{namespace}/replicasets

Parameters

响应

200 (ReplicaSet): OK

201 (ReplicaSet): Created

202 (ReplicaSet): Accepted

401: 未授权

update 替换指定的 ReplicaSet

HTTP 请求

PUT /apis/apps/v1/namespaces/{namespace}/replicasets/{name}

Parameters

响应

200 (ReplicaSet): OK

201 (ReplicaSet): Created

401: 未授权

update 替换指定 ReplicaSet 的状态

HTTP 请求

PUT /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status

Parameters

响应

200 (ReplicaSet): OK

201 (ReplicaSet): Created

401: 未授权

patch 部分更新指定的 ReplicaSet

HTTP 请求

PATCH /apis/apps/v1/namespaces/{namespace}/replicasets/{name}

Parameters

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

    ReplicaSet 的名称

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

    命名空间

  • body: Patch, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (in query): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (ReplicaSet): OK

201 (ReplicaSet): Created

401: 未授权

patch 部分更新指定 ReplicaSet 的状态

HTTP 请求

PATCH /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status

Parameters

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

    ReplicaSet 的名称

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

    命名空间

  • body: Patch, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (in query): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (ReplicaSet): OK

201 (ReplicaSet): Created

401: 未授权

delete 删除一个 ReplicaSet

HTTP 请求

DELETE /apis/apps/v1/namespaces/{namespace}/replicasets/{name}

Parameters

响应

200 (Status): 确定

202 (Status): 已接受

401: 未授权

deletecollection 删除 ReplicaSet 集合

HTTP 请求

DELETE /apis/apps/v1/namespaces/{namespace}/replicasets

Parameters

响应

200 (Status): 确定

401: 未授权


最后修改时间 2025 年 12 月 21 日 下午 5:37 PST: 更新 v1.35 的资源文档 (85b57273c5)

本页面是自动生成的。

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