Lease

apiVersion: coordination.k8s.io/v1

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

Lease defines a lease concept.

• apiVersion: coordination.k8s.io/v1

• kind: Lease

• spec ()

  spec contains the specification of the Lease. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

LeaseSpec is a specification of a Lease.

• acquireTime (MicroTime)

  acquireTime is a time when the current lease was acquired.

  MicroTime is version of Time with microsecond level precision.

• holderIdentity (string)

  holderIdentity contains the identity of the holder of a current lease.

• leaseDurationSeconds (int32)

  leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measure against time of last observed renewTime.

• leaseTransitions (int32)

  leaseTransitions is the number of transitions of a lease between holders.

• renewTime (MicroTime)

  renewTime is a time when the current holder of a lease has last updated the lease.

  MicroTime is version of Time with microsecond level precision.

LeaseList is a list of Lease objects.

• apiVersion: coordination.k8s.io/v1

• kind: LeaseList

• metadata ()

  Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

• items ([]), required

  items is a list of schema objects.

HTTP Request

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

Parameters

• name (in path): string, required

  name of the Lease

• namespace (in path): string, required

  namespace

• pretty (in query): string

Response

200 (): OK

401: Unauthorized

list list or watch objects of kind Lease

HTTP Request

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

Parameters

• namespace (in path): string, required

• allowWatchBookmarks (in query): boolean

  allowWatchBookmarks

• continue (in query): string

• fieldSelector (in query): string

  fieldSelector

• labelSelector (in query): string

• limit (in query): integer

  limit

• pretty (in query): string

• resourceVersion (in query): string

  resourceVersion

• resourceVersionMatch (in query): string

• sendInitialEvents (in query): boolean

  sendInitialEvents

• timeoutSeconds (in query): integer

• watch (in query): boolean

Response

200 (): OK

401: Unauthorized

HTTP Request

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

Parameters

• allowWatchBookmarks (in query): boolean

• continue (in query): string

  continue

• fieldSelector (in query): string

• labelSelector (in query): string

  labelSelector

• limit (in query): integer

• pretty (in query): string

  pretty

• resourceVersion (in query): string

• resourceVersionMatch (in query): string

  resourceVersionMatch

• sendInitialEvents (in query): boolean

• timeoutSeconds (in query): integer

  timeoutSeconds

• watch (in query): boolean

Response

200 (): OK

401: Unauthorized

create create a Lease

HTTP Request

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

Parameters

• namespace (in path): string, required

• body: Lease, required

• fieldManager (in query): string

• fieldValidation (in query): string

  fieldValidation

• pretty (in query): string

Response

200 (): OK

201 (Lease): Created

202 (): Accepted

401: Unauthorized

HTTP Request

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

Parameters

• name (in path): string, required

  name of the Lease

• namespace (in path): string, required

• body: Lease, required

• dryRun (in query): string

• fieldManager (in query): string

  fieldManager

• fieldValidation (in query): string

• pretty (in query): string

  pretty

Response

200 (Lease): OK

201 (): Created

401: Unauthorized

patch partially update the specified Lease

HTTP Request

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

Parameters

• name (in path): string, required

• namespace (in path): string, required

• body: Patch, required

• dryRun (in query): string

• fieldManager (in query): string

  fieldManager

• fieldValidation (in query): string

• force (in query): boolean

  force

• pretty (in query): string

Response

200 (): OK

201 (Lease): Created

401: Unauthorized

HTTP Request

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

Parameters

• name (in path): string, required

  name of the Lease

• namespace (in path): string, required

  namespace

• body:

• dryRun (in query): string

  dryRun

• gracePeriodSeconds (in query): integer

• pretty (in query): string

  pretty

• propagationPolicy (in query): string

Response

200 (): OK

202 (Status): Accepted

401: Unauthorized

deletecollection delete collection of Lease

HTTP Request

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

Parameters

• namespace (in path): string, required

  namespace

• body:

• continue (in query): string

  continue

• dryRun (in query): string

• fieldSelector (in query): string

  fieldSelector

• gracePeriodSeconds (in query): integer

• labelSelector (in query): string

  labelSelector

• limit (in query): integer

• pretty (in query): string

  pretty

• propagationPolicy (in query): string

• resourceVersion (in query): string

  resourceVersion

• resourceVersionMatch (in query): string

• sendInitialEvents (in query): boolean

  sendInitialEvents

Response

200 (Status): OK