你正在查看的文档所针对的是 Kubernetes 版本： v1.30
Kubernetes v1.30 版本的文档已不再维护。你现在看到的版本来自于一份静态的快照。如需查阅最新文档，请点击 最新版本。
ReplicaSet
apiVersion: apps/v1
import "k8s.io/api/apps/v1"
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 是 ReplicaSet 的规约。
-
selector (LabelSelector)，必需
selector 是针对 Pod 的标签查询，应与副本计数匹配。标签的主键和取值必须匹配， 以便由这个 ReplicaSet 进行控制。它必须与 Pod 模板的标签匹配。更多信息： https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/labels/#label-selectors
-
template (PodTemplateSpec)
template 是描述 Pod 的一个对象，将在检测到副本不足时创建此对象。更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/replicationcontroller#pod-template
-
replicas (int32)
replicas 是预期副本的数量。这是一个指针，用于辨别显式零和未指定的值。默认为 1。更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller
-
minReadySeconds (int32)
新建的 Pod 在没有任何容器崩溃的情况下就绪并被系统视为可用的最短秒数。 默认为 0（Pod 就绪后即被视为可用）。
ReplicaSetStatus
ReplicaSetStatus 表示 ReplicaSet 的当前状态。
-
replicas (int32)，必需
replicas 是最近观测到的副本数量。更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller
-
availableReplicas (int32)
此副本集可用副本（至少 minReadySeconds 才能就绪）的数量。
-
readyReplicas (int32)
readyReplicas 是此 ReplicaSet 在就绪状况下处理的目标 Pod 数量。
-
fullyLabeledReplicas (int32)
标签与 ReplicaSet 的 Pod 模板标签匹配的 Pod 数量。
-
conditions ([]ReplicaSetCondition)
补丁策略：按照键
type合并表示副本集当前状态的最新可用观测值。
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 是多个 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/replicationcontroller
操作
get 读取指定的 ReplicaSet
HTTP 请求
GET /apis/apps/v1/namespaces/{namespace}/replicasets/{name}
参数
-
name (路径参数): string，必需
ReplicaSet 的名称
-
namespace (路径参数): string，必需
-
pretty (查询参数): string
响应
200 (ReplicaSet): OK
401: Unauthorized
get 读取指定的 ReplicaSet 的状态
HTTP 请求
GET /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status
参数
-
name (路径参数): string，必需
ReplicaSet 的名称
-
namespace (路径参数): string，必需
-
pretty (查询参数): string
响应
200 (ReplicaSet): OK
401: Unauthorized
list 列出或监视 ReplicaSet 类别的对象
HTTP 请求
GET /apis/apps/v1/namespaces/{namespace}/replicasets
参数
-
namespace (路径参数): string，必需
-
allowWatchBookmarks (查询参数): boolean
-
continue (查询参数): string
-
fieldSelector (查询参数): string
-
labelSelector (查询参数): string
-
limit (查询参数): integer
-
pretty (查询参数): string
-
resourceVersion (查询参数): string
-
resourceVersionMatch (查询参数): string
-
sendInitialEvents (查询参数): boolean
-
timeoutSeconds (查询参数): integer
-
watch (查询参数): boolean
响应
200 (ReplicaSetList): OK
401: Unauthorized
list 列出或监视 ReplicaSet 类别的对象
HTTP 请求
GET /apis/apps/v1/replicasets
参数
-
allowWatchBookmarks (查询参数): boolean
-
continue (查询参数): string
-
fieldSelector (查询参数): string
-
labelSelector (查询参数): string
-
limit (查询参数): integer
-
pretty (查询参数): string
-
resourceVersion (查询参数): string
-
resourceVersionMatch (查询参数): string
-
sendInitialEvents (查询参数): boolean
-
timeoutSeconds (查询参数): integer
-
watch (查询参数): boolean
响应
200 (ReplicaSetList): OK
401: Unauthorized
create 创建 ReplicaSet
HTTP 请求
POST /apis/apps/v1/namespaces/{namespace}/replicasets
参数
-
namespace (路径参数): string，必需
-
body: ReplicaSet，必需
-
dryRun (查询参数): string
-
fieldManager (查询参数): string
-
fieldValidation (查询参数): string
-
pretty (查询参数): string
响应
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，必需
-
body: ReplicaSet，必需
-
dryRun (查询参数): string
-
fieldManager (查询参数): string
-
fieldValidation (查询参数): string
-
pretty (查询参数): string
响应
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，必需
-
body: ReplicaSet，必需
-
dryRun (查询参数): string
-
fieldManager (查询参数): string
-
fieldValidation (查询参数): string
-
pretty (查询参数): string
响应
200 (ReplicaSet): OK
201 (ReplicaSet): Created
401: Unauthorized
patch 部分更新指定的 ReplicaSet
HTTP 请求
PATCH /apis/apps/v1/namespaces/{namespace}/replicasets/{name}
参数
-
name (路径参数): string，必需
ReplicaSet 的名称
-
namespace (路径参数): string，必需
-
body: Patch，必需
-
dryRun (查询参数): string
-
fieldManager (查询参数): string
-
fieldValidation (查询参数): string
-
force (查询参数): boolean
-
pretty (查询参数): string
响应
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，必需
-
body: Patch，必需
-
dryRun (查询参数): string
-
fieldManager (查询参数): string
-
fieldValidation (查询参数): string
-
force (查询参数): boolean
-
pretty (查询参数): string
响应
200 (ReplicaSet): OK
201 (ReplicaSet): Created
401: Unauthorized
delete 删除 ReplicaSet
HTTP 请求
DELETE /apis/apps/v1/namespaces/{namespace}/replicasets/{name}
参数
-
name (路径参数): string，必需
ReplicaSet 的名称
-
namespace (路径参数): string，必需
-
body: DeleteOptions
-
dryRun (查询参数): string
-
gracePeriodSeconds (查询参数): integer
-
pretty (查询参数): string
-
propagationPolicy (查询参数): string
响应
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
deletecollection 删除 ReplicaSet 的集合
HTTP 请求
DELETE /apis/apps/v1/namespaces/{namespace}/replicasets
参数
-
namespace (路径参数): string，必需
-
body: DeleteOptions
-
continue (查询参数): string
-
dryRun (查询参数): string
-
fieldSelector (查询参数): string
-
gracePeriodSeconds (查询参数): integer
-
labelSelector (查询参数): string
-
limit (查询参数): integer
-
pretty (查询参数): string
-
propagationPolicy (查询参数): string
-
resourceVersion (查询参数): string
-
resourceVersionMatch (查询参数): string
-
sendInitialEvents (查询参数): boolean
-
timeoutSeconds (查询参数): integer
响应
200 (Status): OK
401: Unauthorized