--- api_metadata: apiVersion: "apps/v1" import: "k8s.io/api/apps/v1" kind: "ReplicaSet" content_type: "api_reference" description: "ReplicaSet 确保在任何给定的时刻都在运行指定数量的 Pod 副本。" title: "ReplicaSet" weight: 6 --- `apiVersion: apps/v1` `import "k8s.io/api/apps/v1"` ## ReplicaSet {#ReplicaSet} ReplicaSet 确保在任何给定的时刻都在运行指定数量的 Pod 副本。

- **apiVersion**: apps/v1 - **kind**: ReplicaSet - **metadata** (}}">ObjectMeta) 如果 ReplicaSet 的标签为空，则这些标签默认为与 ReplicaSet 管理的 Pod 相同。标准的对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata - **spec** (}}">ReplicaSetSpec) `spec` 定义 ReplicaSet 预期行为的规约。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status - **status** (}}">ReplicaSetStatus) `status` 是最近观测到的 ReplicaSet 状态。此数据可能在某个时间窗之后过期。该值由系统填充，只读。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status ## ReplicaSetSpec {#ReplicaSetSpec} ReplicaSetSpec 是 ReplicaSet 的规约。

- **selector** (}}">LabelSelector)，必需 `selector` 是针对 Pod 的标签查询，应与副本计数匹配。标签的主键和取值必须匹配，以便由这个 ReplicaSet 进行控制。它必须与 Pod 模板的标签匹配。更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/replicaset/#pod-template - **template** (}}">PodTemplateSpec) `template` 是描述 Pod 的一个对象，将在检测到副本不足时创建此对象。更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/replicationcontroller#pod-template - **replicas** (int32) `replicas` 是预期 Pod 的数量。这是一个指针，用于辨别显式零和未指定的值。默认为 1。更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/replicaset - **minReadySeconds** (int32) 新建的 Pod 在没有任何容器崩溃的情况下就绪并被系统视为可用的最短秒数。默认为 0（Pod 就绪后即被视为可用）。 ## ReplicaSetStatus {#ReplicaSetStatus} ReplicaSetStatus 表示 ReplicaSet 的当前状态。

- **replicas** (int32)，必需 `replicas` 是最近观测到的非终止状态 Pod 的数量。更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/replicaset - **availableReplicas** (int32) 此副本集可用的非终止状态 Pod（至少 `minReadySeconds` 才能就绪）的数量。 - **readyReplicas** (int32) 此 ReplicaSet 所针对是的处于 Ready 状况的非终止 Pod 的数量。 - **terminatingReplicas** (int32) 此副本集正在终止的 Pod 的数量。正在终止的 Pod 是具有非空 `.metadata.deletionTimestamp` 的 Pod，并且尚未达到 Failed 或 Succeeded 的 `.status.phase` 状态。这是一个 Beta 阶段的字段，需要启用 DeploymentReplicaSetTerminatingReplicas 特性门控（默认启用）。 - **fullyLabeledReplicas** (int32) 标签与 ReplicaSet 的 Pod 模板标签匹配的非终止状态 Pod 的数量。 - **conditions** ([]ReplicaSetCondition) **补丁策略：按照键 `type` 合并** **Map：键类型的唯一值将在合并期间保留** 表示副本集当前状态的最新可用观测值。 **ReplicaSetCondition 描述某个点的副本集状态。** - **conditions.status** (string)，必需状况的状态，取值为 `True`、`False` 或 `Unknown` 之一。 - **conditions.type** (string)，必需副本集状况的类型。 - **conditions.lastTransitionTime** (Time) 状况上次从一个状态转换为另一个状态的时间。 **Time 是对 time.Time 的封装。Time 支持对 YAML 和 JSON 进行正确封包。为 time 包的许多函数方法提供了封装器。** - **conditions.message** (string) 这是一条人类可读的消息，指示有关上次转换的详细信息。 - **conditions.reason** (string) 状况上次转换的原因。 - **observedGeneration** (int64) `observedGeneration` 反映了最近观测到的 ReplicaSet 生成情况。 ## ReplicaSetList {#ReplicaSetList} ReplicaSetList 是多个 ReplicaSet 的集合。

- **apiVersion**: apps/v1 - **kind**: ReplicaSetList - **metadata** (}}">ListMeta) 标准的列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds - **items** ([]}}">ReplicaSet)，必需 ReplicaSet 的列表。更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/replicaset ## 操作 {#Operations}

### `get` 读取指定的 ReplicaSet #### HTTP 请求 GET /apis/apps/v1/namespaces/{namespace}/replicasets/{name} #### 参数 - **name** (**路径参数**): string，必需 ReplicaSet 的名称。 - **namespace** (**路径参数**): string，必需 }}">namespace - **pretty** (**查询参数**): string }}">pretty #### 响应 200 (}}">ReplicaSet): OK 401: Unauthorized ### `get` 读取指定的 ReplicaSet 的状态 #### HTTP 请求 GET /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status #### 参数 - **name** (**路径参数**): string，必需 ReplicaSet 的名称。 - **namespace** (**路径参数**): string，必需 }}">namespace - **pretty** (**查询参数**): string }}">pretty #### 响应 200 (}}">ReplicaSet): OK 401: Unauthorized ### `list` 列出或监视 ReplicaSet 类别的对象 #### HTTP 请求 GET /apis/apps/v1/namespaces/{namespace}/replicasets #### 参数 - **namespace** (**路径参数**): string，必需 }}">namespace - **allowWatchBookmarks** (**查询参数**): boolean }}">allowWatchBookmarks - **continue** (**查询参数**): string }}">continue - **fieldSelector** (**查询参数**): string }}">fieldSelector - **labelSelector** (**查询参数**): string }}">labelSelector - **limit** (**查询参数**): integer }}">limit - **pretty** (**查询参数**): string }}">pretty - **resourceVersion** (**查询参数**): string }}">resourceVersion - **resourceVersionMatch** (**查询参数**): string }}">resourceVersionMatch - **sendInitialEvents** (**查询参数**): boolean }}">sendInitialEvents - **shardSelector** (**查询参数**): string }}">shardSelector - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds - **watch** (**查询参数**): boolean }}">watch #### 响应 200 (}}">ReplicaSetList): OK 401: Unauthorized ### `list` 列出或监视 ReplicaSet 类别的对象 #### HTTP 请求 GET /apis/apps/v1/replicasets #### 参数 - **allowWatchBookmarks** (**查询参数**): boolean }}">allowWatchBookmarks - **continue** (**查询参数**): string }}">continue - **fieldSelector** (**查询参数**): string }}">fieldSelector - **labelSelector** (**查询参数**): string }}">labelSelector - **limit** (**查询参数**): integer }}">limit - **pretty** (**查询参数**): string }}">pretty - **resourceVersion** (**查询参数**): string }}">resourceVersion - **resourceVersionMatch** (**查询参数**): string }}">resourceVersionMatch - **sendInitialEvents** (**查询参数**): boolean }}">sendInitialEvents - **shardSelector** (**查询参数**): string }}">shardSelector - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds - **watch** (**查询参数**): boolean }}">watch #### 响应 200 (}}">ReplicaSetList): OK 401: Unauthorized ### `create` 创建 ReplicaSet #### HTTP 请求 POST /apis/apps/v1/namespaces/{namespace}/replicasets #### 参数 - **namespace** (**路径参数**): string，必需 }}">namespace - **body**: }}">ReplicaSet，必需 - **dryRun** (**查询参数**): string }}">dryRun - **fieldManager** (**查询参数**): string }}">fieldManager - **fieldValidation** (**查询参数**): string }}">fieldValidation - **pretty** (**查询参数**): string }}">pretty #### 响应 200 (}}">ReplicaSet): OK 201 (}}">ReplicaSet): Created 202 (}}">ReplicaSet): Accepted 401: Unauthorized ### `update` 替换指定的 ReplicaSet #### HTTP 请求 PUT /apis/apps/v1/namespaces/{namespace}/replicasets/{name} #### 参数 - **name** (**路径参数**): string，必需 ReplicaSet 的名称。 - **namespace** (**路径参数**): string，必需 }}">namespace - **body**: }}">ReplicaSet，必需 - **dryRun** (**查询参数**): string }}">dryRun - **fieldManager** (**查询参数**): string }}">fieldManager - **fieldValidation** (**查询参数**): string }}">fieldValidation - **pretty** (**查询参数**): string }}">pretty #### 响应 200 (}}">ReplicaSet): OK 201 (}}">ReplicaSet): Created 401: Unauthorized ### `update` 替换指定的 ReplicaSet 的状态 #### HTTP 请求 PUT /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status #### 参数 - **name** (**路径参数**): string，必需 ReplicaSet 的名称。 - **namespace** (**路径参数**): string，必需 }}">namespace - **body**: }}">ReplicaSet，必需 - **dryRun** (**查询参数**): string }}">dryRun - **fieldManager** (**查询参数**): string }}">fieldManager - **fieldValidation** (**查询参数**): string }}">fieldValidation - **pretty** (**查询参数**): string }}">pretty #### 响应 200 (}}">ReplicaSet): OK 201 (}}">ReplicaSet): Created 401: Unauthorized ### `patch` 部分更新指定的 ReplicaSet #### HTTP 请求 PATCH /apis/apps/v1/namespaces/{namespace}/replicasets/{name} #### 参数 - **name** (**路径参数**): string，必需 ReplicaSet 的名称。 - **namespace** (**路径参数**): string，必需 }}">namespace - **body**: }}">Patch，必需 - **dryRun** (**查询参数**): string }}">dryRun - **fieldManager** (**查询参数**): string }}">fieldManager - **fieldValidation** (**查询参数**): string }}">fieldValidation - **force** (**查询参数**): boolean }}">force - **pretty** (**查询参数**): string }}">pretty #### 响应 200 (}}">ReplicaSet): OK 201 (}}">ReplicaSet): Created 401: Unauthorized ### `patch` 部分更新指定的 ReplicaSet 的状态 #### HTTP 请求 PATCH /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status #### 参数 - **name** (**路径参数**): string，必需 ReplicaSet 的名称。 - **namespace** (**路径参数**): string，必需 }}">namespace - **body**: }}">Patch，必需 - **dryRun** (**查询参数**): string }}">dryRun - **fieldManager** (**查询参数**): string }}">fieldManager - **fieldValidation** (**查询参数**): string }}">fieldValidation - **force** (**查询参数**): boolean }}">force - **pretty** (**查询参数**): string }}">pretty #### 响应 200 (}}">ReplicaSet): OK 201 (}}">ReplicaSet): Created 401: Unauthorized ### `delete` 删除 ReplicaSet #### HTTP 请求 DELETE /apis/apps/v1/namespaces/{namespace}/replicasets/{name} #### 参数 - **name** (**路径参数**): string，必需 ReplicaSet 的名称。 - **namespace** (**路径参数**): string，必需 }}">namespace - **body**: }}">DeleteOptions - **dryRun** (**查询参数**): string }}">dryRun - **gracePeriodSeconds** (**查询参数**): integer }}">gracePeriodSeconds - **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean }}">ignoreStoreReadErrorWithClusterBreakingPotential - **pretty** (**查询参数**): string }}">pretty - **propagationPolicy** (**查询参数**): string }}">propagationPolicy #### 响应 200 (}}">Status): OK 202 (}}">Status): Accepted 401: Unauthorized ### `deletecollection` 删除 ReplicaSet 的集合 #### HTTP 请求 DELETE /apis/apps/v1/namespaces/{namespace}/replicasets #### 参数 - **namespace** (**路径参数**): string，必需 }}">namespace - **body**: }}">DeleteOptions - **continue** (**查询参数**): string }}">continue - **dryRun** (**查询参数**): string }}">dryRun - **fieldSelector** (**查询参数**): string }}">fieldSelector - **gracePeriodSeconds** (**查询参数**): integer }}">gracePeriodSeconds - **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean }}">ignoreStoreReadErrorWithClusterBreakingPotential - **labelSelector** (**查询参数**): string }}">labelSelector - **limit** (**查询参数**): integer }}">limit - **pretty** (**查询参数**): string }}">pretty - **propagationPolicy** (**查询参数**): string }}">propagationPolicy - **resourceVersion** (**查询参数**): string }}">resourceVersion - **resourceVersionMatch** (**查询参数**): string }}">resourceVersionMatch - **sendInitialEvents** (**查询参数**): boolean }}">sendInitialEvents - **shardSelector** (**查询参数**): string }}">shardSelector - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds #### 响应 200 (}}">Status): OK 401: Unauthorized