Lease

    apiVersion: coordination.k8s.io/v1

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

    Lease 定义了租约的概念。

    • apiVersion: coordination.k8s.io/v1

    • metadata ()

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

    • spec ()

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

    LeaseSpec 是一个 Lease 的规范。

    • acquireTime (MicroTime)

      acquireTime 是当前租约被获取的时间。

      MicroTime 是微秒级精确时间的版本。

    • holderIdentity (string)

      holderIdentity 包含当前租约持有人的身份。

    • leaseDurationSeconds (int32)

      leaseDurationSeconds 是租约候选人需要等待强制获取租约的持续时间。这是相对于上次观察到的更新时间的度量。

    • leaseTransitions (int32)

      LeasetTransitions 是租约持有人之间的转换次数。

    • renewTime (MicroTime)

      renewTime 是当前租约持有人上次更新租约的时间。

      MicroTime 是具有微秒级精度的时间版本。

    LeaseList 是 Lease 对象的列表。

    • apiVersion: coordination.k8s.io/v1

    • kind: LeaseList

    • metadata ()

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

    • items ([]), required

    Items 是架构对象的列表。

    HTTP 请求

    GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}

    参数

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

      Lease 名称

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

      namespace

    • pretty (查询参数): string

    响应

    200 (): OK

    401: Unauthorized

    list 列出或监视 Lease 类对象

    HTTP 请求

    GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases

    参数

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

    • 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

    响应

    401: Unauthorized

    HTTP 请求

    GET /apis/coordination.k8s.io/v1/leases

    参数

    • 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 创建 Lease

    HTTP 请求

    POST /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases

    参数

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

    • body: Lease, 必需

    • fieldManager (查询参数): string

    • fieldValidation (查询参数): string

      fieldValidation

    • pretty (查询参数): string

    响应

    200 (): OK

    201 (Lease): Created

    202 (): Accepted

    401: Unauthorized

    HTTP 请求

    PUT /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}

    参数

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

      租贷名称

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

    • body: Lease, 必需

    • dryRun (查询参数): string

    • fieldManager (查询参数): string

      fieldManager

    • fieldValidation (查询参数): string

    • pretty (查询参数): string

      pretty

    响应

    200 (Lease): OK

    201 (): Created

    401: Unauthorized

    patch 部分更新指定的 Lease

    HTTP 请求

    PATCH /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}

    参数

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

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

    • body: Patch, 必需

    • dryRun (查询参数): string

    • fieldManager (查询参数): string

      fieldManager

    • fieldValidation (查询参数): string

    • force (查询参数): boolean

      force

    • pretty (查询参数): string

    响应

    200 (): OK

    201 (Lease): Created

    401: Unauthorized

    HTTP 请求

    DELETE /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}

    参数

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

      租贷的名称

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

      namespace

    • body:

    • dryRun (查询参数): string

      dryRun

    • gracePeriodSeconds (查询参数): integer

    • pretty (查询参数): string

      pretty

    • propagationPolicy (查询参数): string

    响应

    200 (): OK

    202 (Status): Accepted

    401: Unauthorized

    deletecollection 删除 Lease 收款

    HTTP 请求

    DELETE /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases

    参数

    • 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

    响应

    401: Unauthorized