LeaseCandidate v1beta1
apiVersion: coordination.k8s.io/v1beta1
import "k8s.io/api/coordination/v1beta1"
LeaseCandidate
LeaseCandidate визначає кандидата для обʼєкта Lease. Кандидати створюються таким чином, щоб скоординовані вибори лідера обрали найкращого лідера зі списку кандидатів.
apiVersion: coordination.k8s.io/v1beta1
kind: LeaseCandidate
metadata (ObjectMeta)
Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
spec (LeaseCandidateSpec)
spec містить специфікацію Lease. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
LeaseCandidateSpec
LeaseCandidateSpec — це специфікація Lease.
binaryVersion (string), обовʼязково
BinaryVersion - це бінарна версія. Вона має бути у форматі semver без символу
v
. Це поле є обовʼязковим.leaseName (string), обовʼязково
LeaseName — імʼя Lease, на який претендує цей кандидат. Обмеження для цього поля такі ж, як і для Lease.name. Кілька кандидатів на оренду можуть посилатися на один і той самий Lease.name. Це поле є незмінним.
strategy (string), обовʼязково
Strategy — це стратегія, яку координовані вибори лідера будуть використовувати для вибору лідера. Якщо кілька кандидатів на один і той самий Lease повертають різні стратегії, буде використано стратегію, надану кандидатом з найновішою версією BinaryVersion. Якщо конфлікт все ще існує, це є помилкою користувача, і координовані вибори лідера не будуть керувати Lease, доки не буде вирішено.
emulationVersion (string)
EmulationVersion — версія емуляції. Вона має бути у форматі semver без початкового
v
. EmulationVersion має бути менше або дорівнювати BinaryVersion. Це поле є обовʼязковим, якщо стратегія має значення "OldestEmulationVersion"pingTime (MicroTime)
PingTime — це час, коли сервер востаннє запитував LeaseCandidate на поновлення. Це робиться тільки під час виборів лідера, щоб перевірити, чи не став якийсь LeaseCandidate неприйнятним. Коли PingTime буде оновлено, LeaseCandidate відповість оновленням RenewTime.
renewTime (MicroTime)
RenewTime — це час, коли LeaseCandidate востаннє оновлювався. Кожного разу, коли обʼєкту Lease потрібно провести вибори лідера, поле PingTime оновлюється, щоб повідомити обʼєкту LeaseCandidate, що йому слід оновити RenewTime. Старі обʼєкти LeaseCandidate також видаляються, якщо з моменту останнього оновлення пройшло кілька годин. Поле PingTime регулярно оновлюється, щоб запобігти збиранню сміття для все ще активних LeaseCandidates.
LeaseCandidateList
LeaseCandidateList — список обʼєктів Lease.
apiVersion: coordination.k8s.io/v1beta1
kind: LeaseCandidateList
metadata (ListMeta)
Стандартні метадані списку. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
items ([]LeaseCandidate), обовʼязково
items — список об\єктів схеми.
Операції
get
отримати вказаний LeaseCandidate
HTTP запит
GET /apis/coordination.k8s.io/v1beta1/namespaces/{namespace}/leasecandidates/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя LeaseCandidate
namespace (в шляху): string, обовʼязково
pretty (в запиті): string
Відповідь
200 (LeaseCandidate): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу LeaseCandidate
HTTP запит
GET /apis/coordination.k8s.io/v1beta1/namespaces/{namespace}/leasecandidates
Параметри
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 (LeaseCandidateList): OK
401: Unauthorized
list
перелік або перегляд обʼєктів типу LeaseCandidate
HTTP запит
GET /apis/coordination.k8s.io/v1beta1/leasecandidates
Параметри
allowWatchBookmarks (в запиті): boolean
continue (в запиті): string
fieldSelector (в запиті): string
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
watch (в запиті): boolean
Відповідь
200 (LeaseCandidateList): OK
401: Unauthorized
create
створення LeaseCandidate
HTTP запит
POST /apis/coordination.k8s.io/v1beta1/namespaces/{namespace}/leasecandidates
Параметри
namespace (в шляху): string, обовʼязково
body: LeaseCandidate, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (LeaseCandidate): OK
201 (LeaseCandidate): Created
202 (LeaseCandidate): Accepted
401: Unauthorized
update
заміна вказаного LeaseCandidate
HTTP запит
PUT /apis/coordination.k8s.io/v1beta1/namespaces/{namespace}/leasecandidates/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя LeaseCandidate
namespace (в шляху): string, обовʼязково
body: LeaseCandidate, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
pretty (в запиті): string
Відповідь
200 (LeaseCandidate): OK
201 (LeaseCandidate): Created
401: Unauthorized
patch
часткове оновлення вказаного LeaseCandidate
HTTP запит
PATCH /apis/coordination.k8s.io/v1beta1/namespaces/{namespace}/leasecandidates/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя LeaseCandidate
namespace (в шляху): string, обовʼязково
body: Patch, обовʼязково
dryRun (в запиті): string
fieldManager (в запиті): string
fieldValidation (в запиті): string
force (в запиті): boolean
pretty (в запиті): string
Відповідь
200 (LeaseCandidate): OK
201 (LeaseCandidate): Created
401: Unauthorized
delete
видалення LeaseCandidate
HTTP запит
DELETE /apis/coordination.k8s.io/v1beta1/namespaces/{namespace}/leasecandidates/{name}
Параметри
name (в шляху): string, обовʼязково
імʼя LeaseCandidate
namespace (в шляху): string, обовʼязково
body: DeleteOptions
dryRun (в запиті): string
gracePeriodSeconds (в запиті): integer
ignoreStoreReadErrorWithClusterBreakingPotential (в запиті): boolean
pretty (в запиті): string
propagationPolicy (в запиті): string
Відповідь
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
deletecollection
видалення колекції LeaseCandidate
HTTP запит
DELETE /apis/coordination.k8s.io/v1beta1/namespaces/{namespace}/leasecandidates
Параметри
namespace (в шляху): string, обовʼязково
body: DeleteOptions
continue (в запиті): string
dryRun (в запиті): string
fieldSelector (в запиті): string
gracePeriodSeconds (в запиті): integer
ignoreStoreReadErrorWithClusterBreakingPotential (в запиті): boolean
labelSelector (в запиті): string
limit (в запиті): integer
pretty (в запиті): string
propagationPolicy (в запиті): string
resourceVersion (в запиті): string
resourceVersionMatch (в запиті): string
sendInitialEvents (в запиті): boolean
timeoutSeconds (в запиті): integer
Відповідь
200 (Status): OK
401: Unauthorized
Цю сторінку було стоврено автоматично.
Якщо у вас є наміри надіслати пропозиції щодо неї, додайте згадку, про те що сторінку створено автоматично в описі вашого повідомлення. Зміни мають відбутись всюди в проєкті Kubernetes.