ReplicaSet

    apiVersion: apps/v1

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

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

    ReplicaSetSpec 是 ReplicaSet 的规约。

    • selector (LabelSelector)，必需

      selector 是针对 Pod 的标签查询，应与副本计数匹配。标签的主键和取值必须匹配， 以便由这个 ReplicaSet 进行控制。它必须与 Pod 模板的标签匹配。更多信息：

    • template (PodTemplateSpec)

      template 是描述 Pod 的一个对象，将在检测到副本不足时创建此对象。更多信息：

    • replicas (int32)

      replicas 是预期副本的数量。这是一个指针，用于辨别显式零和未指定的值。默认为 1。更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller

    • minReadySeconds (int32)

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

    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 是多个 ReplicaSet 的集合。

    • apiVersion: apps/v1

    • kind: ReplicaSetList

    • metadata (ListMeta)

      标准的列表元数据。更多信息：

    • items ([]ReplicaSet)，必需

      ReplicaSet 的列表。更多信息：

    HTTP 请求

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

    参数

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

      ReplicaSet 的名称

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

      namespace

    • pretty (查询参数): string

    响应

    200 (): OK

    401: Unauthorized

    get 读取指定的 ReplicaSet 的状态

    HTTP 请求

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

    参数

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

      ReplicaSet 的名称

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

    • pretty (查询参数): string

      pretty

    响应

    200 (ReplicaSet): OK

    401: Unauthorized

    列出或监视 ReplicaSet 类别的对象

    HTTP 请求

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

    参数

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

      namespace

    • allowWatchBookmarks (查询参数): boolean

    • continue (查询参数): string

      continue

    • fieldSelector (查询参数): string

    • labelSelector (查询参数): string

      labelSelector

    • limit (查询参数): integer

    • pretty (查询参数): string

    • resourceVersion (查询参数): string

      resourceVersion

    • resourceVersionMatch (查询参数): string

    • timeoutSeconds (查询参数): integer

      timeoutSeconds

    • watch (查询参数): boolean

    响应

    200 (): OK

    401: Unauthorized

    HTTP 请求

    GET /apis/apps/v1/replicasets

    参数

    • allowWatchBookmarks (查询参数): boolean

    • continue (查询参数): string

      continue

    • fieldSelector (查询参数): string

    • labelSelector (查询参数): string

      labelSelector

    • limit (查询参数): integer

    • pretty (查询参数): string

      pretty

    • resourceVersion (查询参数): string

    • resourceVersionMatch (查询参数): string

      resourceVersionMatch

    • timeoutSeconds (查询参数): integer

    • watch (查询参数): boolean

      watch

    响应

    200 (ReplicaSetList): OK

    401: Unauthorized

    create 创建 ReplicaSet

    HTTP 请求

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

    参数

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

      namespace

    • body: ，必需

    • dryRun (查询参数): string

      dryRun

    • fieldValidation (查询参数): string

    • pretty (查询参数): string

      pretty

    响应

    200 (ReplicaSet): OK

    201 (): Created

    202 (ReplicaSet): Accepted

    401: Unauthorized

    update 替换指定的 ReplicaSet

    HTTP 请求

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

    参数

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

      ReplicaSet 的名称

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

      namespace

    • body: ，必需

    • dryRun (查询参数): string

      dryRun

    • fieldManager (查询参数): string

    • fieldValidation (查询参数): string

      fieldValidation

    • pretty (查询参数): string

    响应

    200 (): OK

    201 (ReplicaSet): Created

    401: Unauthorized

    HTTP 请求

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

    参数

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

      ReplicaSet 的名称

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

      namespace

    • body: ，必需

    • dryRun (查询参数): string

      dryRun

    • fieldManager (查询参数): string

    • fieldValidation (查询参数): string

      fieldValidation

    • pretty (查询参数): string

    响应

    200 (): OK

    401: Unauthorized

    patch 部分更新指定的 ReplicaSet

    HTTP 请求

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

    参数

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

      ReplicaSet 的名称

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

    • body: Patch，必需

    • dryRun (查询参数): string

    • fieldManager (查询参数): string

      fieldManager

    • fieldValidation (查询参数): string

    • force (查询参数): boolean

      force

    • pretty (查询参数): string

    响应

    200 (): 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: ，必需

    • dryRun (查询参数): string

      dryRun

    • fieldManager (查询参数): string

    • fieldValidation (查询参数): string

      fieldValidation

    • force (查询参数): boolean

    • pretty (查询参数): string

      pretty

    响应

    200 (ReplicaSet): OK

    201 (): Created

    401: Unauthorized

    HTTP 请求

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

    参数

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

      ReplicaSet 的名称

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

    • body: DeleteOptions

    • dryRun (查询参数): string

    • gracePeriodSeconds (查询参数): integer

      gracePeriodSeconds

    • pretty (查询参数): string

    • propagationPolicy (查询参数): string

      propagationPolicy

    响应

    200 (Status): OK

    202 (): Accepted

    401: Unauthorized

    删除 ReplicaSet 的集合

    HTTP 请求

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

    参数

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

    • body: DeleteOptions

    • continue (查询参数): string

    • dryRun (查询参数): string

      dryRun

    • fieldSelector (查询参数): string

    • gracePeriodSeconds (查询参数): integer

      gracePeriodSeconds

    • labelSelector (查询参数): string

    • limit (查询参数): integer

      limit

    • pretty (查询参数): string

    • propagationPolicy (查询参数): string

      propagationPolicy

    • resourceVersion (查询参数): string

    • resourceVersionMatch (查询参数): string

      resourceVersionMatch

    响应

    200 (Status): OK