大网数据广告活动
Kubernetes 部署与运维

LeaseCandidate v1beta1

· 52CE 我爱测

`apiVersion: coordination.k8s.io/v1beta1`

apiVersion: coordination.k8s.io/v1beta1

import "k8s.io/api/coordination/v1beta1"

LeaseCandidate {#LeaseCandidate}

LeaseCandidate 定义一个 Lease 对象的候选者。 通过创建候选者,协同式领导者选举能够从候选者列表中选出最佳的领导者。

<hr>

  • apiVersion: coordination.k8s.io/v1beta1

  • kind: LeaseCandidate

  • metadata (<a href="">ObjectMeta</a>)

    更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

  • spec (<a href="">LeaseCandidateSpec</a>),必需

    spec 包含 Lease 的规约。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

LeaseCandidateSpec {#LeaseCandidateSpec}

LeaseCandidateSpec 是 Lease 的规约。

<hr>

  • binaryVersion (string),必需

    binaryVersion 是可执行文件的版本。它必须采用不带前缀 v 的语义版本格式。 此字段是必需的。

  • leaseName (string),必需

    leaseName 是此候选者正在争夺的租约的名称。此字段是不可变更的。

  • strategy (string),必需

    strategy 是协调式领导者选举中用于选择领导者的策略。 如果多个候选者针对同一个 Lease 返回了不同的策略,则将采用 binaryVersion 最新的候选者所提供的策略。 如果仍存在冲突,则视为用户错误,协调式领导者选举将不会继续操作此 Lease,直到冲突被解决。

  • emulationVersion (string)

    emulationVersion 是仿真版本。它必须采用不带前缀 v 的语义版本格式。 emulationVersion 必须小于或等于 binaryVersion。 当策略为 "OldestEmulationVersion" 时,此字段是必需的。

  • pingTime (MicroTime)

    pingTime 是服务器最近一次请求 LeaseCandidate 续订的时间。 此操作仅在领导者选举期间进行,用以检查是否有 LeaseCandidates 变得不合格。 当 pingTime 更新时,LeaseCandidate 会通过更新 renewTime 来响应。

    <a name="MicroTime"></a> MicroTime 是微秒级精度的 Time 版本

  • renewTime (MicroTime)

    renewTime 是 LeaseCandidate 被最近一次更新的时间。每当 Lease 需要进行领导者选举时, pingTime 字段会被更新,以向 LeaseCandidate 发出应更新 renewTime 的信号。 如果自上次续订以来已经过去几个小时,旧的 LeaseCandidate 对象也会被垃圾收集。 pingTime 字段会被定期更新,以防止对仍处于活动状态的 LeaseCandidates 进行垃圾收集。

    <a name="MicroTime"></a> MicroTime 是微秒级精度的 Time 版本

LeaseCandidateList {#LeaseCandidateList}

LeaseCandidateList 是 Lease 对象的列表。

<hr>

  • apiVersion: coordination.k8s.io/v1beta1

  • kind: LeaseCandidateList

  • metadata (<a href="">ListMeta</a>)

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

  • items ([]<a href="">LeaseCandidate</a>),必需

    items 是模式对象的列表。

操作 {#Operations}

<hr>

get 读取指定的 LeaseCandidate

HTTP 请求

GET /apis/coordination.k8s.io/v1beta1/namespaces/{namespace}/leasecandidates/{name}

参数

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

    LeaseCandidate 的名称。

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

    <a href="">namespace</a>

  • pretty (查询参数): string

    <a href="">pretty</a>

响应

200 (<a href="">LeaseCandidate</a>): OK

401: Unauthorized

list 列举或监视类别为 LeaseCandidate 的对象

HTTP 请求

GET /apis/coordination.k8s.io/v1beta1/namespaces/{namespace}/leasecandidates

参数

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

    <a href="">namespace</a>

  • allowWatchBookmarks (查询参数): boolean

    <a href="">allowWatchBookmarks</a>

  • continue (查询参数): string

    <a href="">continue</a>

  • fieldSelector (查询参数): string

    <a href="">fieldSelector</a>

  • labelSelector (查询参数): string

    <a href="">labelSelector</a>

  • limit (查询参数): integer

    <a href="">limit</a>

  • pretty (查询参数): string

    <a href="">pretty</a>

  • resourceVersion (查询参数): string

    <a href="">resourceVersion</a>

  • resourceVersionMatch (查询参数): string

    <a href="">resourceVersionMatch</a>

  • sendInitialEvents (查询参数): boolean

    <a href="">sendInitialEvents</a>

  • shardSelector (查询参数): string

    <a href="">shardSelector</a>

  • timeoutSeconds (查询参数): integer

    <a href="">timeoutSeconds</a>

  • watch (查询参数): boolean

    <a href="">watch</a>

响应

200 (<a href="">LeaseCandidateList</a>): OK

401: Unauthorized

list 列举或监视类别为 LeaseCandidate 的对象

HTTP 请求

GET /apis/coordination.k8s.io/v1beta1/leasecandidates

参数

  • allowWatchBookmarks (查询参数): boolean

    <a href="">allowWatchBookmarks</a>

  • continue (查询参数): string

    <a href="">continue</a>

  • fieldSelector (查询参数): string

    <a href="">fieldSelector</a>

  • labelSelector (查询参数): string

    <a href="">labelSelector</a>

  • limit (查询参数): integer

    <a href="">limit</a>

  • pretty (查询参数): string

    <a href="">pretty</a>

  • resourceVersion (查询参数): string

    <a href="">resourceVersion</a>

  • resourceVersionMatch (查询参数): string

    <a href="">resourceVersionMatch</a>

  • sendInitialEvents (查询参数): boolean

    <a href="">sendInitialEvents</a>

  • shardSelector (查询参数): string

    <a href="">shardSelector</a>

  • timeoutSeconds (查询参数): integer

    <a href="">timeoutSeconds</a>

  • watch (查询参数): boolean

    <a href="">watch</a>

响应

200 (<a href="">LeaseCandidateList</a>): OK

401: Unauthorized

create 创建 LeaseCandidate

HTTP 请求

POST /apis/coordination.k8s.io/v1beta1/namespaces/{namespace}/leasecandidates

参数

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

    <a href="">namespace</a>

  • body: <a href="">LeaseCandidate</a>,必需

  • dryRun (查询参数): string

    <a href="">dryRun</a>

  • fieldManager (查询参数): string

    <a href="">fieldManager</a>

  • fieldValidation (查询参数): string

    <a href="">fieldValidation</a>

  • pretty (查询参数): string

    <a href="">pretty</a>

响应

200 (<a href="">LeaseCandidate</a>): OK

201 (<a href="">LeaseCandidate</a>): Created

202 (<a href="">LeaseCandidate</a>): Accepted

401: Unauthorized

update 替换指定的 LeaseCandidate

HTTP 请求

PUT /apis/coordination.k8s.io/v1beta1/namespaces/{namespace}/leasecandidates/{name}

参数

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

    LeaseCandidate 的名称。

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

    <a href="">namespace</a>

  • body: <a href="">LeaseCandidate</a>,必需

  • dryRun (查询参数): string

    <a href="">dryRun</a>

  • fieldManager (查询参数): string

    <a href="">fieldManager</a>

  • fieldValidation (查询参数): string

    <a href="">fieldValidation</a>

  • pretty (查询参数): string

    <a href="">pretty</a>

响应

200 (<a href="">LeaseCandidate</a>): OK

201 (<a href="">LeaseCandidate</a>): Created

401: Unauthorized

patch 部分更新指定的 LeaseCandidate

HTTP 请求

PATCH /apis/coordination.k8s.io/v1beta1/namespaces/{namespace}/leasecandidates/{name}

参数

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

    LeaseCandidate 的名称。

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

    <a href="">namespace</a>

  • body: <a href="">Patch</a>,必需

  • dryRun (查询参数): string

    <a href="">dryRun</a>

  • fieldManager (查询参数): string

    <a href="">fieldManager</a>

  • fieldValidation (查询参数): string

    <a href="">fieldValidation</a>

  • force (查询参数): boolean

    <a href="">force</a>

  • pretty (查询参数): string

    <a href="">pretty</a>

响应

200 (<a href="">LeaseCandidate</a>): OK

201 (<a href="">LeaseCandidate</a>): Created

401: Unauthorized

delete 删除 LeaseCandidate

HTTP 请求

DELETE /apis/coordination.k8s.io/v1beta1/namespaces/{namespace}/leasecandidates/{name}

参数

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

    LeaseCandidate 的名称。

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

    <a href="">namespace</a>

  • body: <a href="">DeleteOptions</a>

  • dryRun (查询参数): string

    <a href="">dryRun</a>

  • gracePeriodSeconds (查询参数): integer

    <a href="">gracePeriodSeconds</a>

  • ignoreStoreReadErrorWithClusterBreakingPotential (查询参数): boolean

    <a href="">ignoreStoreReadErrorWithClusterBreakingPotential</a>

  • pretty (查询参数): string

    <a href="">pretty</a>

  • propagationPolicy (查询参数): string

    <a href="">propagationPolicy</a>

响应

200 (<a href="">Status</a>): OK

202 (<a href="">Status</a>): Accepted

401: Unauthorized

deletecollection 删除 LeaseCandidate 的集合

HTTP 请求

DELETE /apis/coordination.k8s.io/v1beta1/namespaces/{namespace}/leasecandidates

参数

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

    <a href="">namespace</a>

  • body: <a href="">DeleteOptions</a>

  • continue (查询参数): string

    <a href="">continue</a>

  • dryRun (查询参数): string

    <a href="">dryRun</a>

  • fieldSelector (查询参数): string

    <a href="">fieldSelector</a>

  • gracePeriodSeconds (查询参数): integer

    <a href="">gracePeriodSeconds</a>

  • ignoreStoreReadErrorWithClusterBreakingPotential (查询参数): boolean

    <a href="">ignoreStoreReadErrorWithClusterBreakingPotential</a>

  • labelSelector (查询参数): string

    <a href="">labelSelector</a>

  • limit (查询参数): integer

    <a href="">limit</a>

  • pretty (查询参数): string

    <a href="">pretty</a>

  • propagationPolicy (查询参数): string

    <a href="">propagationPolicy</a>

  • resourceVersion (查询参数): string

    <a href="">resourceVersion</a>

  • resourceVersionMatch (查询参数): string

    <a href="">resourceVersionMatch</a>

  • sendInitialEvents (查询参数): boolean

    <a href="">sendInitialEvents</a>

  • shardSelector (查询参数): string

    <a href="">shardSelector</a>

  • timeoutSeconds (查询参数): integer

    <a href="">timeoutSeconds</a>

响应

200 (<a href="">Status</a>): OK

401: Unauthorized

来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
Kubernetes 文档贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。