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。离线整理了版式、链接和媒体显示。
