ReplicationController

apiVersion: v1

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

ReplicationController 表示一个副本控制器的配置。

• apiVersion: v1

• kind: ReplicationController

• spec ()

  spec 定义副本控制器预期行为的规约。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

• status ()

  status 是最近观测到的副本控制器的状态。此数据可能在某个时间窗之后过期。 该值由系统填充，只读。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

ReplicationControllerSpec 表示一个副本控制器的规约。

• selector (map[string]string)

  selector 是针对 Pod 的标签查询，符合条件的 Pod 个数应与 replicas 匹配。 如果 selector 为空，则默认为出现在 Pod 模板中的标签。 如果置空以表示默认使用 Pod 模板中的标签，则标签的主键和取值必须匹配，以便由这个副本控制器进行控制。 更多信息： https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/labels/#label-selectors

• template ()

  template 是描述 Pod 的一个对象，将在检测到副本不足时创建此对象。 此字段优先于 templateRef。更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/replicationcontroller#pod-template

• replicas (int32)

  replicas 是预期副本的数量。这是一个指针，用于辨别显式零和未指定的值。默认为 1。更多信息：

• minReadySeconds (int32)

  新建的 Pod 在没有任何容器崩溃的情况下就绪并被系统视为可用的最短秒数。 默认为 0（Pod 就绪后即被视为可用）。

ReplicationControllerStatus 表示一个副本控制器的当前状态。

• replicas (int32)，必需

  replicas 是最近观测到的副本数量。更多信息：

• availableReplicas (int32)

  这个副本控制器可用副本（至少 minReadySeconds 才能就绪）的数量。

• readyReplicas (int32)

  此副本控制器所用的就绪副本的数量。

• fullyLabeledReplicas (int32)

  标签与副本控制器的 Pod 模板标签匹配的 Pod 数量。

• conditions ([]ReplicationControllerCondition)

  补丁策略：按照键 type 合并

  表示副本控制器当前状态的最新可用观测值。

  ReplicationControllerCondition 描述某个点的副本控制器的状态。

  • 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 反映了最近观测到的副本控制器的生成情况。

ReplicationControllerList 是副本控制器的集合。

• apiVersion: v1

• kind: ReplicationControllerList

• metadata ()

  标准的列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

• items ([])，必需

  副本控制器的列表。更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/replicationcontroller

HTTP 请求

GET /api/v1/namespaces/{namespace}/replicationcontrollers/{name}

参数

• name (路径参数): string，必需

  ReplicationController 的名称

• namespace (路径参数): string，必需

• pretty (查询参数): string

  pretty

响应

200 (ReplicationController): OK

401: Unauthorized

get 读取指定的 ReplicationController 的状态

HTTP 请求

GET /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/status

参数

• name (路径参数): string，必需

  ReplicationController 的名称

• namespace (路径参数): string，必需

  namespace

• pretty (查询参数): string

响应

200 (): OK

401: Unauthorized

列出或监视 ReplicationController 类别的对象

HTTP 请求

GET /api/v1/namespaces/{namespace}/replicationcontrollers

参数

• namespace (路径参数): string，必需

• allowWatchBookmarks (查询参数): boolean

  allowWatchBookmarks

• continue (查询参数): string

• fieldSelector (查询参数): string

  fieldSelector

• labelSelector (查询参数): string

• limit (查询参数): integer

• pretty (查询参数): string

  pretty

• resourceVersion (查询参数): string

• resourceVersionMatch (查询参数): string

  resourceVersionMatch

• timeoutSeconds (查询参数): integer

• watch (查询参数): boolean

  watch

响应

200 (ReplicationControllerList): OK

401: Unauthorized

HTTP 请求

GET /api/v1/replicationcontrollers

参数

• allowWatchBookmarks (查询参数): boolean

  allowWatchBookmarks

• continue (查询参数): string

• fieldSelector (查询参数): string

  fieldSelector

• labelSelector (查询参数): string

• limit (查询参数): integer

  limit

• pretty (查询参数): string

• resourceVersion (查询参数): string

  resourceVersion

• resourceVersionMatch (查询参数): string

• timeoutSeconds (查询参数): integer

  timeoutSeconds

• watch (查询参数): boolean

响应

200 (): OK

401: Unauthorized

create 创建 ReplicationController

HTTP 请求

POST /api/v1/namespaces/{namespace}/replicationcontrollers

参数

• namespace (路径参数): string，必需

• body: ReplicationController，必需

• dryRun (查询参数): string

• fieldValidation (查询参数): string

  fieldValidation

• pretty (查询参数): string

响应

200 (): OK

201 (ReplicationController): Created

202 (): Accepted

401: Unauthorized

update 替换指定的 ReplicationController

HTTP 请求

PUT /api/v1/namespaces/{namespace}/replicationcontrollers/{name}

参数

• name (路径参数): string，必需

  ReplicationController 的名称

• namespace (路径参数): string，必需

• body: ReplicationController，必需

• dryRun (查询参数): string

• fieldManager (查询参数): string

  fieldManager

• fieldValidation (查询参数): string

• pretty (查询参数): string

  pretty

响应

200 (ReplicationController): OK

201 (): Created

401: Unauthorized

HTTP 请求

PUT /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/status

参数

• name (路径参数): string，必需

  ReplicationController 的名称

• namespace (路径参数): string，必需

• body: ReplicationController，必需

• dryRun (查询参数): string

• fieldManager (查询参数): string

  fieldManager

• fieldValidation (查询参数): string

• pretty (查询参数): string

  pretty

响应

200 (ReplicationController): OK

401: Unauthorized

patch 部分更新指定的 ReplicationController

HTTP 请求

PATCH /api/v1/namespaces/{namespace}/replicationcontrollers/{name}

参数

• name (路径参数): string，必需

  ReplicationController 的名称

• namespace (路径参数): string，必需

  namespace

• body: ，必需

• dryRun (查询参数): string

  dryRun

• fieldManager (查询参数): string

• fieldValidation (查询参数): string

  fieldValidation

• force (查询参数): boolean

• pretty (查询参数): string

  pretty

响应

200 (ReplicationController): OK

201 (): Created

401: Unauthorized

patch 部分更新指定的 ReplicationController 的状态

HTTP 请求

PATCH /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/status

参数

• name (路径参数): string，必需

  ReplicationController 的名称

• namespace (路径参数): string，必需

• body: Patch，必需

• dryRun (查询参数): string

• fieldManager (查询参数): string

  fieldManager

• fieldValidation (查询参数): string

• force (查询参数): boolean

  force

• pretty (查询参数): string

响应

200 (): OK

201 (ReplicationController): Created

401: Unauthorized

HTTP 请求

DELETE /api/v1/namespaces/{namespace}/replicationcontrollers/{name}

参数

• name (路径参数): string，必需

  ReplicationController 的名称

• namespace (路径参数): string，必需

  namespace

• body:

• dryRun (查询参数): string

  dryRun

• gracePeriodSeconds (查询参数): integer

• pretty (查询参数): string

  pretty

• propagationPolicy (查询参数): string

响应

200 (): OK

202 (Status): Accepted

401: Unauthorized

删除 ReplicationController 的集合

HTTP 请求

DELETE /api/v1/namespaces/{namespace}/replicationcontrollers

参数

• namespace (路径参数): string，必需

  namespace

• body:

• continue (查询参数): string

  continue

• dryRun (查询参数): string

• fieldSelector (查询参数): string

  fieldSelector

• gracePeriodSeconds (查询参数): integer

• labelSelector (查询参数): string

  labelSelector

• limit (查询参数): integer

• pretty (查询参数): string

  pretty

• propagationPolicy (查询参数): string

• resourceVersion (查询参数): string

  resourceVersion

• resourceVersionMatch (查询参数): string

响应

200 (): OK