Lease
apiVersion: coordination.k8s.io/v1
import "k8s.io/api/coordination/v1"
Lease
Lease визначає концепцію оренди.
apiVersion: coordination.k8s.io/v1
kind: Lease
metadata (ObjectMeta)
Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
spec (LeaseSpec)
Spec містить специфікацію оренди. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
LeaseSpec
LeaseSpec — це специфікація оренди.
acquireTime (MicroTime)
acquireTime — це час, коли поточну оренду було отримано.
holderIdentity (string)
holderIdentity містить ідентифікатор власника поточної оренди. Якщо використовується координований вибір лідера, ідентифікатор власника повинен відповідати значенню поля LeaseCandidate.metadata.name, яке було обране.
leaseDurationSeconds (int32)
leaseDurationSeconds — це тривалість, яку кандидати на оренду повинні чекати, щоб примусово її отримати. Вона вимірюється від часу останнього спостережуваного renewTime.
leaseTransitions (int32)
leaseTransitions — це кількість переходів оренди між власниками.
preferredHolder (string)
PreferredHolder сигналізує тримачу лізингу, що існує більш оптимальний тримач лізингу і що лізинг слід передати. Це поле може бути встановлене лише якщо також встановлена стратегія (Strategy).
renewTime (MicroTime)
renewTime — це час, коли поточний власник оренди останнього разу оновив оренду.
strategy (string)
Strategy вказує стратегію для вибору лідера в координованому виборі лідера. Якщо це поле не вказано, координування для цього лізингу не активне. (Альфа) Для використання цього поля потрібно увімкнути функціональну можливість CoordinatedLeaderElection.
LeaseList
LeaseList — це список обʼєктів Lease.
apiVersion: coordination.k8s.io/v1
kind: LeaseList
metadata (ListMeta)
Стандартні метадані списку. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
items ([]Lease), обовʼязково
items — це список обʼєктів схеми.
Операції
get отримати вказаний Lease
HTTP запит
GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Lease
namespace (в шляху): string, обовʼязково
pretty (в запиті): string
Відповідь
200 (Lease): OK
401: Unauthorized
list перелік або перегляд обʼєктів типу Lease
HTTP запит
GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
Параметри
namespace (в шляху): string, обовʼязково
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (LeaseList): OK
401: Unauthorized
list перелік або перегляд обʼєктів типу Lease
HTTP запит
GET /apis/coordination.k8s.io/v1/leases
Параметри
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (LeaseList): OK
401: Unauthorized
create створення Lease
HTTP запит
POST /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
Параметри
namespace (в шляху): string, обовʼязково
body: Lease, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (Lease): OK
201 (Lease): Created
202 (Lease): Accepted
401: Unauthorized
update заміна вказаного Lease
HTTP запит
PUT /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Lease
namespace (в шляху): string, обовʼязково
body: Lease, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (Lease): OK
201 (Lease): Created
401: Unauthorized
patch часткове оновлення вказаного Lease
HTTP запит
PATCH /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Lease
namespace (в шляху): string, обовʼязково
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (Lease): OK
201 (Lease): Created
401: Unauthorized
delete видалення Lease
HTTP запит
DELETE /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя Lease
namespace (в шляху): string, обовʼязково
body: DeleteOptions
dryRun (в запиті): string
gracePeriodSeconds (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
Відповідь
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
deletecollection видалення колекції Lease
HTTP запит
DELETE /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
Параметри
namespace (в шляху): string, обовʼязково
body: DeleteOptions
continue (в запиті): string
dryRun (в запиті): string
fieldSelector (в запиті): string
gracePeriodSeconds (в запиті): integer
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
Відповідь
200 (Status): OK
401: Unauthorized