website/replication-controller-v1.md at 1df33efcfd18f74e355ccdfebb69f53b98f1f536

32 KiB

Raw Blame History

api_metadata

content_type

description

title

weight

apiVersion	import	kind
v1	k8s.io/api/core/v1	ReplicationController

api_reference

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

ReplicationController

apiVersion: v1

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

ReplicationController

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

apiVersion: v1
kind: ReplicationController

metadata (<a href="{{< ref "../common-definitions/object-meta#ObjectMeta" >}}">ObjectMeta)

如果 ReplicationController 的标签为空，则这些标签默认为与副本控制器管理的 Pod 相同。标准的对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
spec (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationControllerSpec" >}}">ReplicationControllerSpec)

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

status (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationControllerStatus" >}}">ReplicationControllerStatus)

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

ReplicationControllerSpec

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

selector (map[string]string)

selector 是针对 Pod 的标签查询，符合条件的 Pod 个数应与 replicas 匹配。如果 selector 为空，则默认为出现在 Pod 模板中的标签。如果置空以表示默认使用 Pod 模板中的标签，则标签的主键和取值必须匹配，以便由这个副本控制器进行控制。 template.spec.restartPolicy 唯一被允许的值是 Always。更多信息： https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/labels/#label-selectors
template (<a href="{{< ref "../workload-resources/pod-template-v1#PodTemplateSpec" >}}">PodTemplateSpec)

template 是描述 Pod 的一个对象，将在检测到副本不足时创建此对象。此字段优先于 templateRef。更多信息： 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 就绪后即被视为可用）。

ReplicationControllerStatus

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

replicas (int32)，必需

replicas 是最近观测到的副本数量。更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/replicationcontroller#what-is-a-replicationcontroller
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

ReplicationControllerList 是副本控制器的集合。

apiVersion: v1
kind: ReplicationControllerList

metadata (<a href="{{< ref "../common-definitions/list-meta#ListMeta" >}}">ListMeta)

标准的列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
items ([]<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController)，必需

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

操作

`get` 读取指定的 ReplicationController

HTTP 请求

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

参数

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

ReplicationController 的名称
namespace (路径参数): string，必需

<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace
pretty (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty

响应

200 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController): OK

401: Unauthorized

`get` 读取指定的 ReplicationController 的状态

HTTP 请求

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

参数

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

ReplicationController 的名称
namespace (路径参数): string，必需

<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace
pretty (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty

响应

200 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController): OK

401: Unauthorized

`list` 列出或监视 ReplicationController 类别的对象

HTTP 请求

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

参数

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

<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace
allowWatchBookmarks (查询参数): boolean

<a href="{{< ref "../common-parameters/common-parameters#allowWatchBookmarks" >}}">allowWatchBookmarks
continue (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#continue" >}}">continue
fieldSelector (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#fieldSelector" >}}">fieldSelector
labelSelector (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector
limit (查询参数): integer

<a href="{{< ref "../common-parameters/common-parameters#limit" >}}">limit
pretty (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty
resourceVersion (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#resourceVersion" >}}">resourceVersion
resourceVersionMatch (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch
sendInitialEvents (查询参数): boolean

<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents
timeoutSeconds (查询参数): integer

<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds
watch (查询参数): boolean

<a href="{{< ref "../common-parameters/common-parameters#watch" >}}">watch

响应

200 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationControllerList" >}}">ReplicationControllerList): OK

401: Unauthorized

`list` 列出或监视 ReplicationController 类别的对象

HTTP 请求

GET /api/v1/replicationcontrollers

参数

allowWatchBookmarks (查询参数): boolean

<a href="{{< ref "../common-parameters/common-parameters#allowWatchBookmarks" >}}">allowWatchBookmarks
continue (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#continue" >}}">continue
fieldSelector (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#fieldSelector" >}}">fieldSelector
labelSelector (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector
limit (查询参数): integer

<a href="{{< ref "../common-parameters/common-parameters#limit" >}}">limit
pretty (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty
resourceVersion (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#resourceVersion" >}}">resourceVersion
resourceVersionMatch (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch
sendInitialEvents (查询参数): boolean

<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents
timeoutSeconds (查询参数): integer

<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds
watch (查询参数): boolean

<a href="{{< ref "../common-parameters/common-parameters#watch" >}}">watch

响应

200 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationControllerList" >}}">ReplicationControllerList): OK

401: Unauthorized

`create` 创建 ReplicationController

HTTP 请求

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

参数

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

<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace
body: <a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController，必需
dryRun (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#dryRun" >}}">dryRun
fieldManager (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#fieldManager" >}}">fieldManager
fieldValidation (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#fieldValidation" >}}">fieldValidation
pretty (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty

响应

200 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController): OK

201 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController): Created

202 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController): Accepted

401: Unauthorized

`update` 替换指定的 ReplicationController

HTTP 请求

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

参数

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

ReplicationController 的名称
namespace (路径参数): string，必需

<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace
body: <a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController，必需
dryRun (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#dryRun" >}}">dryRun
fieldManager (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#fieldManager" >}}">fieldManager
fieldValidation (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#fieldValidation" >}}">fieldValidation
pretty (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty

响应

200 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController): OK

201 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController): Created

401: Unauthorized

`update` 替换指定的 ReplicationController 的状态

HTTP 请求

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

参数

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

ReplicationController 的名称
namespace (路径参数): string，必需

<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace
body: <a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController，必需
dryRun (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#dryRun" >}}">dryRun
fieldManager (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#fieldManager" >}}">fieldManager
fieldValidation (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#fieldValidation" >}}">fieldValidation
pretty (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty

响应

200 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController): OK

201 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController): Created

401: Unauthorized

`patch` 部分更新指定的 ReplicationController

HTTP 请求

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

参数

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

ReplicationController 的名称
namespace (路径参数): string，必需

<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace
body: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch，必需
dryRun (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#dryRun" >}}">dryRun
fieldManager (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#fieldManager" >}}">fieldManager
fieldValidation (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#fieldValidation" >}}">fieldValidation
force (查询参数): boolean

<a href="{{< ref "../common-parameters/common-parameters#force" >}}">force
pretty (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty

响应

200 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController): OK

201 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController): Created

401: Unauthorized

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

HTTP 请求

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

参数

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

ReplicationController 的名称
namespace (路径参数): string，必需

<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace
body: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch，必需
dryRun (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#dryRun" >}}">dryRun
fieldManager (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#fieldManager" >}}">fieldManager
fieldValidation (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#fieldValidation" >}}">fieldValidation
force (查询参数): boolean

<a href="{{< ref "../common-parameters/common-parameters#force" >}}">force
pretty (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty

响应

200 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController): OK

201 (<a href="{{< ref "../workload-resources/replication-controller-v1#ReplicationController" >}}">ReplicationController): Created

401: Unauthorized

`delete` 删除 ReplicationController

HTTP 请求

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

参数

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

ReplicationController 的名称
namespace (路径参数): string，必需

<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace
body: <a href="{{< ref "../common-definitions/delete-options#DeleteOptions" >}}">DeleteOptions
dryRun (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#dryRun" >}}">dryRun
gracePeriodSeconds (查询参数): integer

<a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds
pretty (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty
propagationPolicy (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#propagationPolicy" >}}">propagationPolicy

响应

200 (<a href="{{< ref "../common-definitions/status#Status" >}}">Status): OK

202 (<a href="{{< ref "../common-definitions/status#Status" >}}">Status): Accepted

401: Unauthorized

`deletecollection` 删除 ReplicationController 的集合

HTTP 请求

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

参数

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

<a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace
body: <a href="{{< ref "../common-definitions/delete-options#DeleteOptions" >}}">DeleteOptions
continue (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#continue" >}}">continue
dryRun (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#dryRun" >}}">dryRun
fieldSelector (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#fieldSelector" >}}">fieldSelector
gracePeriodSeconds (查询参数): integer

<a href="{{< ref "../common-parameters/common-parameters#gracePeriodSeconds" >}}">gracePeriodSeconds
labelSelector (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#labelSelector" >}}">labelSelector
limit (查询参数): integer

<a href="{{< ref "../common-parameters/common-parameters#limit" >}}">limit
pretty (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty
propagationPolicy (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#propagationPolicy" >}}">propagationPolicy
resourceVersion (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#resourceVersion" >}}">resourceVersion
resourceVersionMatch (查询参数): string

<a href="{{< ref "../common-parameters/common-parameters#resourceVersionMatch" >}}">resourceVersionMatch
sendInitialEvents (查询参数): boolean

<a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents
timeoutSeconds (查询参数): integer

<a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds

响应

200 (<a href="{{< ref "../common-definitions/status#Status" >}}">Status): OK

401: Unauthorized

32 KiB Raw Blame History Unescape Escape

ReplicationController

ReplicationControllerSpec

ReplicationControllerStatus

ReplicationControllerList

操作

get 读取指定的 ReplicationController

HTTP 请求

参数

响应

get 读取指定的 ReplicationController 的状态

HTTP 请求

参数

响应

list 列出或监视 ReplicationController 类别的对象

HTTP 请求

参数

响应

list 列出或监视 ReplicationController 类别的对象

HTTP 请求

参数

响应

create 创建 ReplicationController

HTTP 请求

参数

响应

update 替换指定的 ReplicationController

HTTP 请求

参数

响应

update 替换指定的 ReplicationController 的状态

HTTP 请求

参数

响应

patch 部分更新指定的 ReplicationController

HTTP 请求

参数

响应

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

HTTP 请求

参数

响应

delete 删除 ReplicationController

HTTP 请求

参数

响应

deletecollection 删除 ReplicationController 的集合

HTTP 请求

参数

响应

32 KiB

Raw Blame History

`get` 读取指定的 ReplicationController

`get` 读取指定的 ReplicationController 的状态

`list` 列出或监视 ReplicationController 类别的对象

`list` 列出或监视 ReplicationController 类别的对象

`create` 创建 ReplicationController

`update` 替换指定的 ReplicationController

`update` 替换指定的 ReplicationController 的状态

`patch` 部分更新指定的 ReplicationController

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

`delete` 删除 ReplicationController

`deletecollection` 删除 ReplicationController 的集合