Eviction

Eviction ініціює процес виселення, який в ідеалі повинен призвести до коректного виселення .spec.target (наприклад, завершення поду).

Контролер evictionrequest спостерігає за намірами всіх EvictionRequest і перетворює їх на Eviction. Він керує життєвим циклом Eviction. Запитувачі зберігаються в .status.requesters навіть після відкликання їхнього запиту. Якщо всі запитувачі відкличуть свій намір виселення для спільної цілі, виселення буде скасовано. Після видалення всіх EvictionRequest, що відповідають .spec.target цього Eviction, обʼєкт Eviction врешті-решт буде прибрано збирачем сміття.

Якщо ціллю є под, .status.targetResponders заповнюється з Pod.spec.evictionResponders.

Відповідачі повинні спостерігати та спілкуватися через .status, щоб допомогти з виселенням цілі, коли вони бачать свій стан == Active у .status.targetResponders. Структура ResponderStatus потім повинна періодично оновлюватися для вказівки прогресу або завершення процесу виселення кожним відповідачем у .status.responders. Якщо .status.responders[].heartbeatTime не оновлюється протягом терміну heartbeat, визначеного API Eviction (наразі 20 хвилин), виселення передається наступному відповідачу з нижчим пріоритетом.

Якщо інших відповідачів немає і ціллю є под, останній типовий імперативний відповідач imperative-eviction.k8s.io/evictor з пріоритетом 100 виселить под за допомогою імперативного API Eviction (pods/<name>/eviction subresource).

apiVersion: lifecycle.k8s.io/v1alpha1

import "k8s.io/api/lifecycle/v1alpha1"

Eviction

Якщо ціллю є под, .status.targetResponders заповнюється з Pod.spec.evictionResponders.

Поле	Опис
`apiVersion` string	apiVersion визначає версію схеми цього представлення обʼєкта. Сервери повинні конвертувати розпізнані схеми до останнього внутрішнього значення і можуть відхиляти нерозпізнані значення. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind` string	kind визначає тип REST-ресурсу, який представляє цей обʼєкт. Сервери можуть визначати це з точки доступу, до якої клієнт надсилає запити. Не може бути оновлено. У CamelCase. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata` ObjectMeta	Стандартні метадані обʼєкта. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata. .metadata.name, встановлений evictionrequest-controller, є суто інформативним і може змінюватися. Слід використовувати поле .spec.target для точної ідентифікації цілі. Імена запитувачів та відповідачів використовуватимуться як ключі міток і додаватимуться до міток виселення в одному з таких форматів: 1. acme.io/foo: "requester" 2. acme.io/foo: "responder" 3. acme.io/foo: "requester-responder" Див. EvictionParticipantRole для доступних значень міток ролей.
`spec` * EvictionSpec	spec визначає специфікацію виселення. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
`status` EvictionStatus	status представляє останній спостережений стан виселення. Заповнюється відповідачами та evictionrequest-controller. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

EvictionSpec

EvictionSpec — це специфікація Eviction.

Поле	Опис
`target` * EvictionTarget	target містить посилання на обʼєкт (наприклад, под), який слід виселити. Це поле є обовʼязковим і незмінним.

EvictionStatus

EvictionStatus представляє останній спостережуваний статус запиту на виселення.

Поле	Опис
`conditions` Condition array patch strategy: злиття за ключем `type`	conditions містять інформацію про запит на виселення. Специфічні для Eviction умови: TargetEvicted або Failed (керуються evictionrequest-controller). Failed означає, що запит на виселення більше не обробляється жодним відповідачем на виселення. Це може статися, якщо запит скасовано або якщо жоден відповідач не зміг виселити ціль (наприклад, завершити або видалити под). TargetEvicted означає, що ціль було виселено (наприклад, под було завершено або видалено). Максимальна довжина списку умов — 100.
`observedGeneration` integer	observedGeneration — це .metadata.generation обʼєкта Eviction, спостережуваний evictionrequest-controller. Значення спостережуваного покоління не може бути відʼємним і може лише збільшуватися. Мінімальне значення — 1. Це поле керується evictionrequest-controller.
`requesters` Requester array patch strategy: злиття за ключем `name`	requesters дозволяють ідентифікувати сутності, які запросили виселення цілі. Якщо всі requesters відкликають свій намір виселення, виселення буде скасовано. Максимальна довжина списку requesters — 100. Якщо це обмеження перевищено, спершу слід відкинути requesters із наміром Withdrawn.
`responders` ResponderStatus array patch strategy: злиття за ключем `name`	responders представляє статус процесу виселення кожного оголошеного відповідача. Список відповідачів повинен мати ту саму довжину та ті самі поля .name, що й .status.targetResponders. Оновлюватися та змінюватися можуть лише відповідачі, у яких .name має стан Active у .targetResponders[].state. Первинна ініціалізація списку дозволена. Кожен ResponderStatus ініціалізується evictionrequest-controller, а потім керується призначеним відповідачем.
`targetResponders` TargetResponder array patch strategy: злиття за ключем `name`	targetResponders посилаються на відповідачів, які зрештою мають відповісти на це виселення, щоб допомогти з коректним виселенням цілі. Ці відповідачі обираються послідовно, відповідно до їхнього заданого пріоритету, шляхом встановлення стану Active у поле .state обʼєкта TargetResponder. Максимальна кількість активних відповідачів — 1. Зрештою кожен відповідач може опинитися у стані Interrupted, Canceled або Completed. Відповідачі повинні спостерігати за цими станами, щоб керувати своїм життєвим циклом. Якщо ціль є подом, поле заповнюється з .spec.evictionResponders пода. Залежно від цілі до списку можуть додаватися стандартні відповідачі. Стандартні відповідачі: відповідач imperative-eviction.k8s.io/evictor з пріоритетом 100 додається до списку, якщо ціль є подом. Він викликатиме імперативний API Eviction (субресурс pods/<name>/eviction). Цей виклик може не виконатися через PodDisruptionBudgets, які можуть блокувати завершення пода. Він оновить повідомлення відповідача та повторить спробу із зворотним відліком. Максимальна довжина списку відповідачів — 11. Довжина та ключі списку не можуть змінюватися після встановлення. Це поле керується evictionrequest-controller.

EvictionList

EvictionList містить список ресурсів Eviction.

Поле	Опис
`apiVersion` string	apiVersion визначає версію схеми цього представлення обʼєкта. Сервери повинні конвертувати розпізнані схеми до останнього внутрішнього значення і можуть відхиляти нерозпізнані значення. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`items` * Eviction array	items — це список обʼєктів Eviction.
`kind` string	Kind визначає тип REST-ресурсу, який представляє цей обʼєкт. Сервери можуть визначати це з точки доступу, до якої клієнт надсилає запити. Не може бути оновлено. У CamelCase. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata` ListMeta	Стандартні метадані списку. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

EvictionPodReference

EvictionPodReference містить достатньо інформації для розташування підсиланного поду в межах того самого простору назв.

Поле	Опис
`name` * string	name цілі. Це поле є обовʼязковим.
`uid` * string	uid цілі. Його можна знайти в .metadata.uid цілі; це UUID у нижньому регістрі у форматі 8-4-4-4-12. Це поле є обовʼязковим.

EvictionTarget

EvictionTarget містить посилання на обʼєкт, який слід виселити.

Поле	Опис
`pod` EvictionPodReference	pod посилається на под, який підлягає виселенню/завершенню. Поди, які є частиною PodGroup (встановлено .spec.schedulingGroup), не підтримуються.

Requester

Requester дозволяє ідентифікувати субʼєкт, який запросив виселення цілі.

Поле Опис

Поле	Опис
`intent` * string	intent визначає дію, яку слід виконати для вказаної цілі. Eviction означає, що requester зацікавлений у виселенні цілі. Withdrawn означає, що requester більше не зацікавлений у виселенні цілі. Якщо наміри всіх requesters відкликано, виселення буде скасовано. Наслідки скасування: Неактивні відповідачі ніколи не запустяться. Очікується, що активні відповідачі скасують виселення. Завершені (Completed) або перервані (Interrupted) відповідачі не повинні вживати жодних дій. Можливі значення переліку: `"Eviction"` означає, що requester зацікавлений у виселенні цілі. `"Withdrawn"` означає, що requester більше не зацікавлений у виселенні цілі. Якщо наміри всіх requesters відкликано, виселення буде скасовано. Наслідки скасування: неактивні відповідачі ніколи не запустяться; очікується, що активні відповідачі скасують виселення; завершені або перервані відповідачі не повинні вживати жодних дій.
`name` * string	name дозволяє ідентифікувати сутність, яка запросила виселення цілі. Він повинен бути дійсним ключем з доменним префіксом (наприклад, "acme.io/foo"). Це поле повинно бути унікальним для кожного requester. Це поле є обовʼязковим.

intent *
string

intent визначає дію, яку слід виконати для вказаної цілі.

Eviction означає, що requester зацікавлений у виселенні цілі.
Withdrawn означає, що requester більше не зацікавлений у виселенні цілі. Якщо наміри всіх requesters відкликано, виселення буде скасовано.

Наслідки скасування:

Неактивні відповідачі ніколи не запустяться.
Очікується, що активні відповідачі скасують виселення.
Завершені (Completed) або перервані (Interrupted) відповідачі не повинні вживати жодних дій.

Можливі значення переліку:

"Eviction" означає, що requester зацікавлений у виселенні цілі.
"Withdrawn" означає, що requester більше не зацікавлений у виселенні цілі. Якщо наміри всіх requesters відкликано, виселення буде скасовано. Наслідки скасування: неактивні відповідачі ніколи не запустяться; очікується, що активні відповідачі скасують виселення; завершені або перервані відповідачі не повинні вживати жодних дій.

name *
string name дозволяє ідентифікувати сутність, яка запросила виселення цілі. Він повинен бути дійсним ключем з доменним префіксом (наприклад, "acme.io/foo"). Це поле повинно бути унікальним для кожного requester. Це поле є обовʼязковим.

ResponderStatus

ResponderStatus представляє останній спостережуваний статус процесу виселення відповідача. Він повинен оновлюватися лише призначеним відповідачем, імʼя якого вказано в полі .name.

Поле	Опис
`completionTime` Time	completionTime відстежує момент часу, коли відповідач припинив обробку запиту на виселення. Завершення означає, що відповідач повністю або частково завершив процес виселення, що могло призвести до виселення цілі (наприклад, завершення пода). Під час встановлення воно повинно відображати поточний час. Це поле стає незмінним після встановлення.
`expectedCompletionTime` Time	expectedCompletionTime — це момент часу, коли етап процесу виселення, як очікується, завершиться для відповідача. Час не може бути встановлений у минуле. Це поле може бути пропущено, якщо неможливо зробити оцінку.
`heartbeatTime` Time	heartbeatTime — це останній момент часу, коли відповідач повідомив, що процес виселення перебуває в роботі. Під час встановлення воно повинно відображати поточний час. Відповідачі повинні уникати серцебиття частіше, ніж раз на 20 секунд, щоб не перевантажувати площину керування.
`message` string	message надає зрозумілі людині деталі про стан відповідача та процес виселення. Максимальна довжина — 4000 символів.
`name` * string	name дозволяє ідентифікувати відповідача, який реагує на Eviction. Він повинен бути дійсним ключем з доменним префіксом (наприклад, "acme.io/foo"). Це поле ініціалізується Kubernetes і повинно бути унікальним для кожного відповідача. Це поле є обовʼязковим.
`startTime` Time	startTime відстежує момент часу, коли цей відповідач був призначений активним і має почати обробку запиту на виселення. Під час встановлення воно повинно відображати поточний час. Це поле ініціалізується Kubernetes, коли цей відповідач стає активним. Це поле стає незмінним після встановлення.

TargetResponder

TargetResponder дозволяє вказати відповідача, який реагує на Eviction. Відповідачі повинні спостерігати та спілкуватися через API Eviction (див. .state), щоб допомогти з коректним виселенням цілі (наприклад, завершенням поду).

Поле Опис

name *
string name дозволяє ідентифікувати відповідача, який реагує на Eviction. Він повинен бути дійсним ключем з доменним префіксом (наприклад, "acme.io/foo"). Це поле повинно бути унікальним для кожного відповідача. Це поле є обовʼязковим.

priority *
integer priority для цього відповідача. Вищі пріоритети спершу обираються evictionrequest-controller. Якщо є відповідачі з однаковим пріоритетом, буде обраний відповідач, чиє доменне імʼя йде першим в алфавітному порядку доменів вищого рівня. Це означає, що спершу порівнюються за алфавітом мітки верхнього рівня домену, а потім — нижчі мітки домену. Ключ порівнюється останнім. Відповідач, який є керуючим контролером пода, повинен встановити значення цього поля на 10000, щоб дозволити випередження або резервну реєстрацію іншими відповідачами. Мінімальне значення — 0, а максимальне — 100000. Інтервал 0-999 зарезервований для відповідачів із суфіксом *.k8s.io. Це поле є обовʼязковим і незмінним.

Поле	Опис
`name` * string	name дозволяє ідентифікувати відповідача, який реагує на Eviction. Він повинен бути дійсним ключем з доменним префіксом (наприклад, "acme.io/foo"). Це поле повинно бути унікальним для кожного відповідача. Це поле є обовʼязковим.
`priority` * integer	priority для цього відповідача. Вищі пріоритети спершу обираються evictionrequest-controller. Якщо є відповідачі з однаковим пріоритетом, буде обраний відповідач, чиє доменне імʼя йде першим в алфавітному порядку доменів вищого рівня. Це означає, що спершу порівнюються за алфавітом мітки верхнього рівня домену, а потім — нижчі мітки домену. Ключ порівнюється останнім. Відповідач, який є керуючим контролером пода, повинен встановити значення цього поля на 10000, щоб дозволити випередження або резервну реєстрацію іншими відповідачами. Мінімальне значення — 0, а максимальне — 100000. Інтервал 0-999 зарезервований для відповідачів із суфіксом *.k8s.io. Це поле є обовʼязковим і незмінним.
`state` * string	state визначає стан, який призначається evictionrequest-controller. Відповідачі повинні спостерігати за цим станом, щоб керувати своїм життєвим циклом. Inactive означає, що відповідач поки що не повинен обробляти цей запит на виселення. Active означає, що відповідач або запущений, або очікується, що він скоро запуститься. Також evictionrequest-controller встановив startTime у ResponderStatus. Активний відповідач повинен наразі взаємодіяти з процесом виселення, оновлюючи .status.responders, де .name — це імʼя активного відповідача. Поля ResponderStatus слід періодично оновлювати, щоб вказувати на прогрес або завершення процесу виселення. Якщо поле .status.responders[].heartbeatTime не оновлюється протягом дедлайну серцебиття, визначеного API Eviction (зараз 20 хвилин), виселення передається наступному відповідачу з нижчим пріоритетом. Лише один відповідач може бути активним одночасно. Interrupted означає, що відповідач не зміг запуститися або не зміг вчасно оновити heartbeatTime у ResponderStatus. Canceled означає, що відповідача скасовано. Іншими словами, немає EvictionRequest з тією самою ціллю та наміром Eviction у .spec.intent. Completed означає, що відповідач успішно завершив роботу та встановив completionTime у ResponderStatus. Детальніше про кожного відповідача див. у ResponderStatus у .status.responders. Можливі значення переліку: `"Active"` означає, що відповідач або запущений, або очікується, що він скоро запуститься. Також evictionrequest-controller встановив startTime у ResponderStatus. Активний відповідач повинен наразі взаємодіяти з процесом виселення, оновлюючи .status.responders, де .name — це імʼя активного відповідача. Поля ResponderStatus слід періодично оновлювати, щоб вказувати на прогрес або завершення процесу виселення. Якщо поле .status.responders[].heartbeatTime не оновлюється протягом дедлайну серцебиття, визначеного API Eviction (зараз 20 хвилин), виселення передається наступному відповідачу з нижчим пріоритетом. Лише один відповідач може бути активним одночасно. `"Canceled"` означає, що відповідача скасовано. Іншими словами, немає EvictionRequest з тією самою ціллю та наміром Eviction у .spec.intent. `"Completed"` означає, що відповідач успішно завершив роботу та встановив completionTime у ResponderStatus. `"Inactive"` означає, що відповідач поки що не повинен обробляти цей запит на виселення. `"Interrupted"` означає, що відповідач не зміг запуститися або не зміг вчасно оновити heartbeatTime у ResponderStatus.

state *
string

state визначає стан, який призначається evictionrequest-controller. Відповідачі повинні спостерігати за цим станом, щоб керувати своїм життєвим циклом.

Inactive означає, що відповідач поки що не повинен обробляти цей запит на виселення.
Active означає, що відповідач або запущений, або очікується, що він скоро запуститься. Також evictionrequest-controller встановив startTime у ResponderStatus. Активний відповідач повинен наразі взаємодіяти з процесом виселення, оновлюючи .status.responders, де .name — це імʼя активного відповідача. Поля ResponderStatus слід періодично оновлювати, щоб вказувати на прогрес або завершення процесу виселення. Якщо поле .status.responders[].heartbeatTime не оновлюється протягом дедлайну серцебиття, визначеного API Eviction (зараз 20 хвилин), виселення передається наступному відповідачу з нижчим пріоритетом. Лише один відповідач може бути активним одночасно.
Interrupted означає, що відповідач не зміг запуститися або не зміг вчасно оновити heartbeatTime у ResponderStatus.
Canceled означає, що відповідача скасовано. Іншими словами, немає EvictionRequest з тією самою ціллю та наміром Eviction у .spec.intent.
Completed означає, що відповідач успішно завершив роботу та встановив completionTime у ResponderStatus.

Детальніше про кожного відповідача див. у ResponderStatus у .status.responders.

Можливі значення переліку:

"Active" означає, що відповідач або запущений, або очікується, що він скоро запуститься. Також evictionrequest-controller встановив startTime у ResponderStatus. Активний відповідач повинен наразі взаємодіяти з процесом виселення, оновлюючи .status.responders, де .name — це імʼя активного відповідача. Поля ResponderStatus слід періодично оновлювати, щоб вказувати на прогрес або завершення процесу виселення. Якщо поле .status.responders[].heartbeatTime не оновлюється протягом дедлайну серцебиття, визначеного API Eviction (зараз 20 хвилин), виселення передається наступному відповідачу з нижчим пріоритетом. Лише один відповідач може бути активним одночасно.
"Canceled" означає, що відповідача скасовано. Іншими словами, немає EvictionRequest з тією самою ціллю та наміром Eviction у .spec.intent.
"Completed" означає, що відповідач успішно завершив роботу та встановив completionTime у ResponderStatus.
"Inactive" означає, що відповідач поки що не повинен обробляти цей запит на виселення.
"Interrupted" означає, що відповідач не зміг запуститися або не зміг вчасно оновити heartbeatTime у ResponderStatus.

Операції

`post` Create

HTTP Запит

POST /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictions

Параметри шляху

Назва	Тип	Опис
`namespace`	string	назва обʼєкта та область автентифікації, наприклад для команд та проєктів

Параметри запиту

Назва	Тип	Опис
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).
`dryRun`	string	Коли параметр присутній, це вказує, що зміни не повинні зберігатися. Неправильна або нерозпізнана директива dryRun призведе до помилки та припинення обробки запиту. Дійсні значення: All: всі етапи dry run будуть виконані
`fieldManager`	string	fieldManager є імʼям, повʼязаним з а́ктором або сутністю, яка вносить ці зміни. Значення повинно бути менше або дорівнювати 128 символам і містити лише друковані символи, як визначено в https://golang.org/pkg/unicode/#IsPrint.
`fieldValidation`	string	fieldValidation інструктує сервер, як обробляти обʼєкти в запиті (POST/PUT/PATCH), що містять невідомі або дубльовані поля. Дійсні значення: Ignore: Ігнорує всі невідомі поля, які без попередження видаляються з обʼєкта, а також ігнорує всі дублікати полів, крім останнього, на які натрапляє декодер. Це стандартна поведінка до v1.23. Warn: Надсилає попередження через стандартний заголовок відповіді для кожного невідомого поля, яке видаляється з обʼєкта, і для кожного дубльованого поля, яке зустрічається. Запит все ще буде успішним, якщо немає інших помилок, і буде зберігатися лише останнє з будь-яких дубльованих полів. Це стандартна поведінка у v1.23+ Strict: У цьому випадку запит завершиться з помилкою BadRequest, якщо з обʼєкта будуть вилучені невідомі поля або якщо будуть виявлені дублікати полів. Помилка, що повертається сервером, міститиме всі виявлені невідомі та дубльовані поля.

Параметри тіла запиту

Назва	Тип	Опис
`body`	Eviction

Відповідь

Статус	Опис	Відповідь
200	OK	Eviction
201	Created	Eviction
202	Accepted	Eviction

`patch` Patch

HTTP Запит

PATCH /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictions/{name}

Параметри шляху

Назва	Тип	Опис
`name`	string	назва обʼєкта Eviction
`namespace`	string	назва обʼєкта та область автентифікації, наприклад для команд та проєктів

Параметри запиту

Назва	Тип	Опис
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).
`dryRun`	string	Коли параметр присутній, це вказує, що зміни не повинні зберігатися. Неправильна або нерозпізнана директива dryRun призведе до помилки та припинення обробки запиту. Дійсні значення: All: всі етапи dry run будуть виконані
`fieldManager`	string	fieldManager є імʼям, повʼязаним з а́ктором або сутністю, яка вносить ці зміни. Значення повинно бути менше або дорівнювати 128 символам і містити лише друковані символи, як визначено в https://golang.org/pkg/unicode/#IsPrint. Це поле є обовʼязковим для запитів apply (application/apply-patch), але необовʼязковим для типів patch, що не є apply (JsonPatch, MergePatch, StrategicMergePatch).
`fieldValidation`	string	fieldValidation інструктує сервер, як обробляти обʼєкти в запиті (POST/PUT/PATCH), що містять невідомі або дубльовані поля. Дійсні значення: Ignore: Ігнорує всі невідомі поля, які без попередження видаляються з обʼєкта, а також ігнорує всі дублікати полів, крім останнього, на які натрапляє декодер. Це стандартна поведінка до v1.23. Warn: Надсилає попередження через стандартний заголовок відповіді для кожного невідомого поля, яке видаляється з обʼєкта, і для кожного дубльованого поля, яке зустрічається. Запит все ще буде успішним, якщо немає інших помилок, і буде зберігатися лише останнє з будь-яких дубльованих полів. Це стандартна поведінка у v1.23+ Strict: У цьому випадку запит завершиться з помилкою BadRequest, якщо з обʼєкта будуть вилучені невідомі поля або якщо будуть виявлені дублікати полів. Помилка, що повертається сервером, міститиме всі виявлені невідомі та дубльовані поля.
`force`	boolean	Force здійснює "примусове" виконання запитів Apply. Це означає, що користувач повторно отримає конфліктні поля, що належать іншим людям. Прапорець Force повинен бути не встановлений для запитів patch, що не є apply.

Параметри тіла запиту

Назва	Тип	Опис
`body`	Patch

Відповідь

Статус	Опис	Відповідь
200	OK	Eviction
201	Created	Eviction

`put` Replace

HTTP Запит

PUT /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictions/{name}

Параметри шляху

Назва	Тип	Опис
`name`	string	назва обʼєкта Eviction
`namespace`	string	назва обʼєкта та область автентифікації, наприклад для команд та проєктів

Параметри запиту

Назва	Тип	Опис
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).
`dryRun`	string	Коли параметр присутній, це вказує, що зміни не повинні зберігатися. Неправильна або нерозпізнана директива dryRun призведе до помилки та припинення обробки запиту. Дійсні значення: All: всі етапи dry run будуть виконані
`fieldManager`	string	fieldManager є імʼям, повʼязаним з а́ктором або сутністю, яка вносить ці зміни. Значення повинно бути менше або дорівнювати 128 символам і містити лише друковані символи, як визначено в https://golang.org/pkg/unicode/#IsPrint.
`fieldValidation`	string	fieldValidation інструктує сервер, як обробляти обʼєкти в запиті (POST/PUT/PATCH), що містять невідомі або дубльовані поля. Дійсні значення: Ignore: Ігнорує всі невідомі поля, які без попередження видаляються з обʼєкта, а також ігнорує всі дублікати полів, крім останнього, на які натрапляє декодер. Це стандартна поведінка до v1.23. Warn: Надсилає попередження через стандартний заголовок відповіді для кожного невідомого поля, яке видаляється з обʼєкта, і для кожного дубльованого поля, яке зустрічається. Запит все ще буде успішним, якщо немає інших помилок, і буде зберігатися лише останнє з будь-яких дубльованих полів. Це стандартна поведінка у v1.23+ Strict: У цьому випадку запит завершиться з помилкою BadRequest, якщо з обʼєкта будуть вилучені невідомі поля або якщо будуть виявлені дублікати полів. Помилка, що повертається сервером, міститиме всі виявлені невідомі та дубльовані поля.

Параметри тіла запиту

Назва	Тип	Опис
`body`	Eviction

Відповідь

Статус	Опис	Відповідь
200	OK	Eviction
201	Created	Eviction

`delete` Delete

HTTP Запит

DELETE /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictions/{name}

Параметри шляху

Назва	Тип	Опис
`name`	string	назва обʼєкта Eviction
`namespace`	string	назва обʼєкта та область автентифікації, наприклад для команд та проєктів

Параметри запиту

Назва	Тип	Опис
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).
`dryRun`	string	Коли параметр присутній, це вказує, що зміни не повинні зберігатися. Неправильна або нерозпізнана директива dryRun призведе до помилки та припинення обробки запиту. Дійсні значення: All: всі етапи dry run будуть виконані
`gracePeriodSeconds`	integer	Тривалість у секундах перед видаленням обʼєкта. Значення повинно бути невідʼємним цілим числом. Значення нуль вказує на негайне видалення. Якщо це значення дорівнює nil, буде використано стандартний період очікування для вказаного типу. Стандартно — значення для кожного обʼєкта, якщо не вказано. Нуль означає негайне видалення.
`ignoreStoreReadErrorWithClusterBreakingPotential`	boolean	якщо встановлено true, це запустить небезпечне видалення ресурсу у випадку, якщо звичайний процес вилення завершується помилкою пошкодженого обʼєкта. Ресурс вважається пошкодженим, якщо його не вдається успішно отримати з базового сховища через a) неможливість трансформації даних (наприклад, помилка розшифрування), або b) неможливість декодування в обʼєкт. ПРИМІТКА: небезпечне видалення ігнорує обмеження фіналізаторів, пропускає перевірки попередніх умов і видаляє обʼєкт зі сховища. ПОПЕРЕДЖЕННЯ: це може потенційно порушити кластер, якщо робоче навантаження, повʼязане з ресурсом, що видаляється небезпечним чином, покладається на звичайний процес вилення. Використовуйте лише якщо ВИ ПОВНІСТЮ розумієте, що робите. Стандартне значення — false, і користувач повинен погодитися на активацію.
`orphanDependents`	boolean	Застаріле: будь ласка, використовуйте PropagationPolicy, це поле буде застарілим у версії 1.7. Чи повинні залежні обʼєкти бути осиротілими. Якщо true/false, фіналізатор "orphan" буде додано/видалено зі списку фіналізаторів обʼєкта. Може бути встановлено або це поле, або PropagationPolicy, але не обидва.
`propagationPolicy`	string	Чи та як буде виконано збирання сміття. Може бути встановлено або це поле, або OrphanDependents, але не обидва. Стандартна політика визначається існуючим фіналізатором у metadata.finalizers та стандартною політикою для конкретного ресурсу. Допустимі значення: 'Orphan' — осиротити залежні обʼєкти; 'Background' — дозволити збирачу сміття видалити залежні обʼєкти у фоновому режимі; 'Foreground' — каскадна політика, яка видаляє всі залежні обʼєкти у передньому плані.

Параметри тіла запиту

Назва	Тип	Опис
`body`	DeleteOptions

Відповідь

Статус	Опис	Відповідь
200	OK	Status
202	Accepted	Status

`delete` Delete Collection

HTTP Запит

DELETE /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictions

Параметри шляху

Назва	Тип	Опис
`namespace`	string	назва обʼєкта та область автентифікації, наприклад для команд та проєктів

Параметри запиту

Назва	Тип	Опис
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).
`continue`	string	Параметр continue слід встановлювати при отриманні додаткових результатів від сервера. Оскільки це значення визначається сервером, клієнти можуть використовувати значення continue лише з попереднього результату запиту з ідентичними параметрами запиту (крім значення continue), і сервер може відхилити значення continue, яке він не визнає. Якщо вказане значення continue більше не дійсне через термін дії (зазвичай від пʼяти до пʼятнадцяти хвилин) або зміну конфігурації на сервері, сервер поверне помилку 410 ResourceExpired разом з токеном continue. Якщо клієнту потрібен послідовний список, його необхідно перезапустити без поля continue. В іншому випадку клієнт може надіслати інший запит на отримання списку з токеном, отриманим з помилкою 410, і сервер поверне список, починаючи з наступного ключа, але з останнього знімка, що є непослідовним з попередніми результатами списку — обʼєкти, створені, змінені або видалені після першого запиту списку, будуть включені у відповідь, поки їхні ключі знаходяться після "наступного ключа". Це поле не підтримується, коли watch дорівнює true. Клієнти можуть почати спостереження з останнього значення resourceVersion, повернутого сервером, і не пропустити жодних змін.
`dryRun`	string	Коли параметр присутній, це вказує, що зміни не повинні зберігатися. Неправильна або нерозпізнана директива dryRun призведе до помилки та припинення обробки запиту. Дійсні значення: All: всі етапи dry run будуть виконані
`fieldSelector`	string	Селектор для обмеження списку повернутих обʼєктів за їхніми полями. Стандартно — все.
`gracePeriodSeconds`	integer	Тривалість у секундах перед видаленням обʼєкта. Значення повинно бути невідʼємним цілим числом. Значення нуль вказує на негайне видалення. Якщо це значення дорівнює nil, буде використано стандартний період очікування для вказаного типу. Стандартно — значення для кожного обʼєкта, якщо не вказано. Нуль означає негайне видалення.
`ignoreStoreReadErrorWithClusterBreakingPotential`	boolean	якщо встановлено true, це запустить небезпечне видалення ресурсу у випадку, якщо звичайний процес вилення завершується помилкою пошкодженого обʼєкта. Ресурс вважається пошкодженим, якщо його не вдається успішно отримати з базового сховища через a) неможливість трансформації даних (наприклад, помилка розшифрування), або b) неможливість декодування в обʼєкт. ПРИМІТКА: небезпечне видалення ігнорує обмеження фіналізаторів, пропускає перевірки попередніх умов і видаляє обʼєкт зі сховища. ПОПЕРЕДЖЕННЯ: це може потенційно порушити кластер, якщо робоче навантаження, повʼязане з ресурсом, що видаляється небезпечним чином, покладається на звичайний процес вилення. Використовуйте лише якщо ВИ ПОВНІСТЮ розумієте, що робите. Стандартне значення — false, і користувач повинен погодитися на активацію.
`labelSelector`	string	Селектор для обмеження списку повернутих обʼєктів за їхніми мітками. Стандартно — все.
`limit`	integer	limit — це максимальна кількість відповідей для повернення у виклику списку. Якщо існує більше елементів, сервер встановить поле `continue` у метаданих списку на значення, яке можна використовувати з тим самим початковим запитом для отримання наступного набору результатів. Встановлення ліміту може повернути менше запитаної кількості елементів (до нуля елементів), якщо всі запитані обʼєкти відфільтровані, і клієнти повинні використовувати наявність поля continue для визначення наявності додаткових результатів. Сервери можуть не підтримувати аргумент limit і повертатимуть усі доступні результати. Якщо limit вказано, а поле continue порожнє, клієнти можуть припустити, що додаткові результати відсутні. Це поле не підтримується, якщо watch дорівнює true. Гарантується, що обʼєкти, повернуті при використанні continue, будуть ідентичними одноразовому виклику списку без ліміту — тобто жодні обʼєкти, створені, змінені або видалені після першого запиту, не будуть включені у наступні запити з continue. Це іноді називається послідовним знімком і забезпечує клієнту, який використовує limit для отримання менших частин дуже великого результату, можливість побачити всі можливі обʼєкти. Якщо обʼєкти оновлюються під час розбитого на частини списку, повертається версія обʼєкта, яка була на момент розрахунку першого результату списку.
`orphanDependents`	boolean	Застаріле: будь ласка, використовуйте PropagationPolicy, це поле буде застарілим у версії 1.7. Чи повинні залежні обʼєкти бути осиротілими. Якщо true/false, фіналізатор "orphan" буде додано/видалено зі списку фіналізаторів обʼєкта. Може бути встановлено або це поле, або PropagationPolicy, але не обидва.
`propagationPolicy`	string	Чи та як буде виконано збирання сміття. Може бути встановлено або це поле, або OrphanDependents, але не обидва. Стандартна політика визначається існуючим фіналізатором у metadata.finalizers та стандартною політикою для конкретного ресурсу. Допустимі значення: 'Orphan' — осиротити залежні обʼєкти; 'Background' — дозволити збирачу сміття видалити залежні обʼєкти у фоновому режимі; 'Foreground' — каскадна політика, яка видаляє всі залежні обʼєкти у передньому плані.
`resourceVersion`	string	resourceVersion встановлює обмеження щодо того, з яких версій ресурсу може обслуговуватися запит. Детальніше: https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions. Стандартно — не встановлено
`resourceVersionMatch`	string	resourceVersionMatch визначає, як resourceVersion застосовується до викликів списку. Наполегливо рекомендується встановлювати resourceVersionMatch для викликів списку, де встановлено resourceVersion. Детальніше: https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions. Стандартно — не встановлено
`sendInitialEvents`	boolean	Параметр `sendInitialEvents=true` може бути встановлений разом із `watch=true`. У цьому випадку потік спостереження почнеться із синтетичних подій, щоб відобразити поточний стан обʼєктів у колекції. Після того, як усі такі події буде надіслано, буде надіслано синтетичну подію "Bookmark". Ця подія повідомить ResourceVersion (RV), що відповідає набору обʼєктів, і буде позначена анотацією `"k8s.io/initial-events-end": "true"`. Далі потік спостереження продовжиться як зазвичай, надсилаючи події, що відповідають змінам (після цієї RV) обʼєктів, за якими ведеться спостереження. Коли встановлено параметр `sendInitialEvents`, ми вимагаємо, щоб також був встановлений параметр `resourceVersionMatch`. Семантика запиту на спостереження така: - `resourceVersionMatch` = NotOlderThan інтерпретується як "дані принаймні такі ж нові, як наданий `resourceVersion`", і подія-bookmark надсилається, коли стан синхронізовано до `resourceVersion`, принаймні так само свіжого, як наданий у ListOptions. Якщо `resourceVersion` не встановлено, це інтерпретується як "consistent read", і подія-bookmark надсилається, коли стан синхронізовано принаймні до моменту початку обробки запиту. - `resourceVersionMatch`, встановлений у будь-яке інше значення або не встановлений, повертає помилку Invalid. За замовчуванням true, якщо `resourceVersion=""` або `resourceVersion="0"` (з міркувань зворотної сумісності), і false в інших випадках.
`shardSelector`	string	shardSelector обмежує список повернутих обʼєктів за допомогою виразу селектора шардів на основі CEL. Формат використовує функцію shardRange() разом із \|\| (логічне АБО) для вказання одного або кількох діапазонів хешів: shardRange(object.metadata.uid, '0x0', '0x8000000000000000') shardRange(object.metadata.uid, '0x0', '0x8000000000000000') \|\| shardRange(object.metadata.uid, '0x8000000000000000', '0x10000000000000000') Шляхи до полів використовують синтаксис із коренем в обʼєкті в стилі CEL (наприклад, "object.metadata.uid"), а НЕ формат fieldSelector ("metadata.uid"). Наразі підтримуються такі шляхи: - object.metadata.uid - object.metadata.namespace hexStart і hexEnd є рядковими літералами CEL в одинарних лапках з префіксом '0x', що визначають інклюзивну нижню та ексклюзивну верхню межі в 64-бітному просторі хешів FNV-1a. Повний діапазон — [0x0, 0x10000000000000000), де ексклюзивна верхня межа дорівнює 2^64. Приклади: Розділення на 2 шарди: шард 0: shardRange(object.metadata.uid, '0x0000000000000000', '0x8000000000000000') шард 1: shardRange(object.metadata.uid, '0x8000000000000000', '0x10000000000000000') Розділення на 4 шарди: шард 0: shardRange(object.metadata.uid, '0x0000000000000000', '0x4000000000000000') шард 1: shardRange(object.metadata.uid, '0x4000000000000000', '0x8000000000000000') шард 2: shardRange(object.metadata.uid, '0x8000000000000000', '0xc000000000000000') шард 3: shardRange(object.metadata.uid, '0xc000000000000000', '0x10000000000000000') Це альфа-поле і вимагає увімкнення функціональної можливості ShardedListAndWatch.
`timeoutSeconds`	integer	Час очікування для виклику списку/спостереження. Це обмежує тривалість виклику, незалежно від активності чи бездіяльності.

Параметри тіла запиту

Назва	Тип	Опис
`body`	DeleteOptions

Відповідь

Статус	Опис	Відповідь
200	OK	Status

`get` Read

HTTP Запит

GET /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictions/{name}

Параметри шляху

Назва	Тип	Опис
`name`	string	назва обʼєкта Eviction
`namespace`	string	назва обʼєкта та область автентифікації, наприклад для команд та проєктів

Параметри запиту

Назва	Тип	Опис
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).

Відповідь

Статус	Опис	Відповідь
200	OK	Eviction

`get` List

HTTP Запит

GET /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictions

Параметри шляху

Назва	Тип	Опис
`namespace`	string	назва обʼєкта та область автентифікації, наприклад для команд та проєктів

Параметри запиту

Назва	Тип	Опис
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).
`allowWatchBookmarks`	boolean	Дозволяє запити подій спостереження з типом "BOOKMARK". Сервери, які не реалізовують закладки, можуть ігнорувати цей прапорець, а закладки надсилаються на розсуд сервера. Клієнти не повинні припускати, що закладки повертаються через будь-який конкретний інтервал, а також не повинні припускати, що сервер надсилатиме будь-яку подію BOOKMARK під час сеансу. Якщо це не спостереження, це поле ігнорується.
`continue`	string	Параметр continue слід встановлювати при отриманні додаткових результатів від сервера. Оскільки це значення визначається сервером, клієнти можуть використовувати значення continue лише з попереднього результату запиту з ідентичними параметрами запиту (крім значення continue), і сервер може відхилити значення continue, яке він не визнає. Якщо вказане значення continue більше не дійсне через термін дії (зазвичай від пʼяти до пʼятнадцяти хвилин) або зміну конфігурації на сервері, сервер поверне помилку 410 ResourceExpired разом з токеном continue. Якщо клієнту потрібен послідовний список, його необхідно перезапустити без поля continue. В іншому випадку клієнт може надіслати інший запит на отримання списку з токеном, отриманим з помилкою 410, і сервер поверне список, починаючи з наступного ключа, але з останнього знімка, що є непослідовним з попередніми результатами списку — обʼєкти, створені, змінені або видалені після першого запиту списку, будуть включені у відповідь, поки їхні ключі знаходяться після "наступного ключа". Це поле не підтримується, коли watch дорівнює true. Клієнти можуть почати спостереження з останнього значення resourceVersion, повернутого сервером, і не пропустити жодних змін.
`fieldSelector`	string	Селектор для обмеження списку повернутих обʼєктів за їхніми полями. Стандартно — все.
`labelSelector`	string	Селектор для обмеження списку повернутих обʼєктів за їхніми мітками. Стандартно — все.
`limit`	integer	limit — це максимальна кількість відповідей для повернення у виклику списку. Якщо існує більше елементів, сервер встановить поле `continue` у метаданих списку на значення, яке можна використовувати з тим самим початковим запитом для отримання наступного набору результатів. Встановлення ліміту може повернути менше запитаної кількості елементів (до нуля елементів), якщо всі запитані обʼєкти відфільтровані, і клієнти повинні використовувати наявність поля continue для визначення наявності додаткових результатів. Сервери можуть не підтримувати аргумент limit і повертатимуть усі доступні результати. Якщо limit вказано, а поле continue порожнє, клієнти можуть припустити, що додаткові результати відсутні. Це поле не підтримується, якщо watch дорівнює true. Гарантується, що обʼєкти, повернуті при використанні continue, будуть ідентичними одноразовому виклику списку без ліміту — тобто жодні обʼєкти, створені, змінені або видалені після першого запиту, не будуть включені у наступні запити з continue. Це іноді називається послідовним знімком і забезпечує клієнту, який використовує limit для отримання менших частин дуже великого результату, можливість побачити всі можливі обʼєкти. Якщо обʼєкти оновлюються під час розбитого на частини списку, повертається версія обʼєкта, яка була на момент розрахунку першого результату списку.
`resourceVersion`	string	resourceVersion встановлює обмеження щодо того, з яких версій ресурсу може обслуговуватися запит. Детальніше: https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions. Стандартно — не встановлено
`resourceVersionMatch`	string	resourceVersionMatch визначає, як resourceVersion застосовується до викликів списку. Наполегливо рекомендується встановлювати resourceVersionMatch для викликів списку, де встановлено resourceVersion. Детальніше: https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions. Стандартно — не встановлено
`sendInitialEvents`	boolean	Параметр `sendInitialEvents=true` може бути встановлений разом із `watch=true`. У цьому випадку потік спостереження почнеться із синтетичних подій, щоб відобразити поточний стан обʼєктів у колекції. Після того, як усі такі події буде надіслано, буде надіслано синтетичну подію "Bookmark". Ця подія повідомить ResourceVersion (RV), що відповідає набору обʼєктів, і буде позначена анотацією `"k8s.io/initial-events-end": "true"`. Далі потік спостереження продовжиться як зазвичай, надсилаючи події, що відповідають змінам (після цієї RV) обʼєктів, за якими ведеться спостереження. Коли встановлено параметр `sendInitialEvents`, ми вимагаємо, щоб також був встановлений параметр `resourceVersionMatch`. Семантика запиту на спостереження така: - `resourceVersionMatch` = NotOlderThan інтерпретується як "дані принаймні такі ж нові, як наданий `resourceVersion`", і подія-bookmark надсилається, коли стан синхронізовано до `resourceVersion`, принаймні так само свіжого, як наданий у ListOptions. Якщо `resourceVersion` не встановлено, це інтерпретується як "consistent read", і подія-bookmark надсилається, коли стан синхронізовано принаймні до моменту початку обробки запиту. - `resourceVersionMatch`, встановлений у будь-яке інше значення або не встановлений, повертає помилку Invalid. За замовчуванням true, якщо `resourceVersion=""` або `resourceVersion="0"` (з міркувань зворотної сумісності), і false в інших випадках.
`shardSelector`	string	shardSelector обмежує список повернутих обʼєктів за допомогою виразу селектора шардів на основі CEL. Формат використовує функцію shardRange() разом із \|\| (логічне АБО) для вказання одного або кількох діапазонів хешів: shardRange(object.metadata.uid, '0x0', '0x8000000000000000') shardRange(object.metadata.uid, '0x0', '0x8000000000000000') \|\| shardRange(object.metadata.uid, '0x8000000000000000', '0x10000000000000000') Шляхи до полів використовують синтаксис із коренем в обʼєкті в стилі CEL (наприклад, "object.metadata.uid"), а НЕ формат fieldSelector ("metadata.uid"). Наразі підтримуються такі шляхи: - object.metadata.uid - object.metadata.namespace hexStart і hexEnd є рядковими літералами CEL в одинарних лапках з префіксом '0x', що визначають інклюзивну нижню та ексклюзивну верхню межі в 64-бітному просторі хешів FNV-1a. Повний діапазон — [0x0, 0x10000000000000000), де ексклюзивна верхня межа дорівнює 2^64. Приклади: Розділення на 2 шарди: шард 0: shardRange(object.metadata.uid, '0x0000000000000000', '0x8000000000000000') шард 1: shardRange(object.metadata.uid, '0x8000000000000000', '0x10000000000000000') Розділення на 4 шарди: шард 0: shardRange(object.metadata.uid, '0x0000000000000000', '0x4000000000000000') шард 1: shardRange(object.metadata.uid, '0x4000000000000000', '0x8000000000000000') шард 2: shardRange(object.metadata.uid, '0x8000000000000000', '0xc000000000000000') шард 3: shardRange(object.metadata.uid, '0xc000000000000000', '0x10000000000000000') Це альфа-поле і вимагає увімкнення функціональної можливості ShardedListAndWatch.
`timeoutSeconds`	integer	Час очікування для виклику списку/спостереження. Це обмежує тривалість виклику, незалежно від активності чи бездіяльності.
`watch`	boolean	Спостерігати за змінами описаних ресурсів і повертати їх як потік сповіщень про додавання, оновлення та видалення. Вкажіть resourceVersion.

Відповідь

Статус	Опис	Відповідь
200	OK	EvictionList

`get` List All Namespaces

HTTP Запит

GET /apis/lifecycle.k8s.io/v1alpha1/evictions

Параметри запиту

Назва	Тип	Опис
`allowWatchBookmarks`	boolean	Дозволяє запити подій спостереження з типом "BOOKMARK". Сервери, які не реалізовують закладки, можуть ігнорувати цей прапорець, а закладки надсилаються на розсуд сервера. Клієнти не повинні припускати, що закладки повертаються через будь-який конкретний інтервал, а також не повинні припускати, що сервер надсилатиме будь-яку подію BOOKMARK під час сеансу. Якщо це не спостереження, це поле ігнорується.
`continue`	string	Параметр continue слід встановлювати при отриманні додаткових результатів від сервера. Оскільки це значення визначається сервером, клієнти можуть використовувати значення continue лише з попереднього результату запиту з ідентичними параметрами запиту (крім значення continue), і сервер може відхилити значення continue, яке він не визнає. Якщо вказане значення continue більше не дійсне через термін дії (зазвичай від пʼяти до пʼятнадцяти хвилин) або зміну конфігурації на сервері, сервер поверне помилку 410 ResourceExpired разом з токеном continue. Якщо клієнту потрібен послідовний список, його необхідно перезапустити без поля continue. В іншому випадку клієнт може надіслати інший запит на отримання списку з токеном, отриманим з помилкою 410, і сервер поверне список, починаючи з наступного ключа, але з останнього знімка, що є непослідовним з попередніми результатами списку — обʼєкти, створені, змінені або видалені після першого запиту списку, будуть включені у відповідь, поки їхні ключі знаходяться після "наступного ключа". Це поле не підтримується, коли watch дорівнює true. Клієнти можуть почати спостереження з останнього значення resourceVersion, повернутого сервером, і не пропустити жодних змін.
`fieldSelector`	string	Селектор для обмеження списку повернутих обʼєктів за їхніми полями. Стандартно — все.
`labelSelector`	string	Селектор для обмеження списку повернутих обʼєктів за їхніми мітками. Стандартно — все.
`limit`	integer	limit — це максимальна кількість відповідей для повернення у виклику списку. Якщо існує більше елементів, сервер встановить поле `continue` у метаданих списку на значення, яке можна використовувати з тим самим початковим запитом для отримання наступного набору результатів. Встановлення ліміту може повернути менше запитаної кількості елементів (до нуля елементів), якщо всі запитані обʼєкти відфільтровані, і клієнти повинні використовувати наявність поля continue для визначення наявності додаткових результатів. Сервери можуть не підтримувати аргумент limit і повертатимуть усі доступні результати. Якщо limit вказано, а поле continue порожнє, клієнти можуть припустити, що додаткові результати відсутні. Це поле не підтримується, якщо watch дорівнює true. Гарантується, що обʼєкти, повернуті при використанні continue, будуть ідентичними одноразовому виклику списку без ліміту — тобто жодні обʼєкти, створені, змінені або видалені після першого запиту, не будуть включені у наступні запити з continue. Це іноді називається послідовним знімком і забезпечує клієнту, який використовує limit для отримання менших частин дуже великого результату, можливість побачити всі можливі обʼєкти. Якщо обʼєкти оновлюються під час розбитого на частини списку, повертається версія обʼєкта, яка була на момент розрахунку першого результату списку.
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).
`resourceVersion`	string	resourceVersion встановлює обмеження щодо того, з яких версій ресурсу може обслуговуватися запит. Детальніше: https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions. Стандартно — не встановлено
`resourceVersionMatch`	string	resourceVersionMatch визначає, як resourceVersion застосовується до викликів списку. Наполегливо рекомендується встановлювати resourceVersionMatch для викликів списку, де встановлено resourceVersion. Детальніше: https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions. Стандартно — не встановлено
`sendInitialEvents`	boolean	Параметр `sendInitialEvents=true` може бути встановлений разом із `watch=true`. У цьому випадку потік спостереження почнеться із синтетичних подій, щоб відобразити поточний стан обʼєктів у колекції. Після того, як усі такі події буде надіслано, буде надіслано синтетичну подію "Bookmark". Ця подія повідомить ResourceVersion (RV), що відповідає набору обʼєктів, і буде позначена анотацією `"k8s.io/initial-events-end": "true"`. Далі потік спостереження продовжиться як зазвичай, надсилаючи події, що відповідають змінам (після цієї RV) обʼєктів, за якими ведеться спостереження. Коли встановлено параметр `sendInitialEvents`, ми вимагаємо, щоб також був встановлений параметр `resourceVersionMatch`. Семантика запиту на спостереження така: - `resourceVersionMatch` = NotOlderThan інтерпретується як "дані принаймні такі ж нові, як наданий `resourceVersion`", і подія-bookmark надсилається, коли стан синхронізовано до `resourceVersion`, принаймні так само свіжого, як наданий у ListOptions. Якщо `resourceVersion` не встановлено, це інтерпретується як "consistent read", і подія-bookmark надсилається, коли стан синхронізовано принаймні до моменту початку обробки запиту. - `resourceVersionMatch`, встановлений у будь-яке інше значення або не встановлений, повертає помилку Invalid. За замовчуванням true, якщо `resourceVersion=""` або `resourceVersion="0"` (з міркувань зворотної сумісності), і false в інших випадках.
`shardSelector`	string	shardSelector обмежує список повернутих обʼєктів за допомогою виразу селектора шардів на основі CEL. Формат використовує функцію shardRange() разом із \|\| (логічне АБО) для вказання одного або кількох діапазонів хешів: shardRange(object.metadata.uid, '0x0', '0x8000000000000000') shardRange(object.metadata.uid, '0x0', '0x8000000000000000') \|\| shardRange(object.metadata.uid, '0x8000000000000000', '0x10000000000000000') Шляхи до полів використовують синтаксис із коренем в обʼєкті в стилі CEL (наприклад, "object.metadata.uid"), а НЕ формат fieldSelector ("metadata.uid"). Наразі підтримуються такі шляхи: - object.metadata.uid - object.metadata.namespace hexStart і hexEnd є рядковими літералами CEL в одинарних лапках з префіксом '0x', що визначають інклюзивну нижню та ексклюзивну верхню межі в 64-бітному просторі хешів FNV-1a. Повний діапазон — [0x0, 0x10000000000000000), де ексклюзивна верхня межа дорівнює 2^64. Приклади: Розділення на 2 шарди: шард 0: shardRange(object.metadata.uid, '0x0000000000000000', '0x8000000000000000') шард 1: shardRange(object.metadata.uid, '0x8000000000000000', '0x10000000000000000') Розділення на 4 шарди: шард 0: shardRange(object.metadata.uid, '0x0000000000000000', '0x4000000000000000') шард 1: shardRange(object.metadata.uid, '0x4000000000000000', '0x8000000000000000') шард 2: shardRange(object.metadata.uid, '0x8000000000000000', '0xc000000000000000') шард 3: shardRange(object.metadata.uid, '0xc000000000000000', '0x10000000000000000') Це альфа-поле і вимагає увімкнення функціональної можливості ShardedListAndWatch.
`timeoutSeconds`	integer	Час очікування для виклику списку/спостереження. Це обмежує тривалість виклику, незалежно від активності чи бездіяльності.
`watch`	boolean	Спостерігати за змінами описаних ресурсів і повертати їх як потік сповіщень про додавання, оновлення та видалення. Вкажіть resourceVersion.

Відповідь

Статус	Опис	Відповідь
200	OK	EvictionList

`get` Watch

HTTP Запит

GET /apis/lifecycle.k8s.io/v1alpha1/watch/namespaces/{namespace}/evictions/{name}

Параметри шляху

Назва	Тип	Опис
`name`	string	назва обʼєкта Eviction
`namespace`	string	назва обʼєкта та область автентифікації, наприклад для команд та проєктів

Параметри запиту

Назва	Тип	Опис
`allowWatchBookmarks`	boolean	Дозволяє запити подій спостереження з типом "BOOKMARK". Сервери, які не реалізовують закладки, можуть ігнорувати цей прапорець, а закладки надсилаються на розсуд сервера. Клієнти не повинні припускати, що закладки повертаються через будь-який конкретний інтервал, а також не повинні припускати, що сервер надсилатиме будь-яку подію BOOKMARK під час сеансу. Якщо це не спостереження, це поле ігнорується.
`continue`	string	Параметр continue слід встановлювати при отриманні додаткових результатів від сервера. Оскільки це значення визначається сервером, клієнти можуть використовувати значення continue лише з попереднього результату запиту з ідентичними параметрами запиту (крім значення continue), і сервер може відхилити значення continue, яке він не визнає. Якщо вказане значення continue більше не дійсне через термін дії (зазвичай від пʼяти до пʼятнадцяти хвилин) або зміну конфігурації на сервері, сервер поверне помилку 410 ResourceExpired разом з токеном continue. Якщо клієнту потрібен послідовний список, його необхідно перезапустити без поля continue. В іншому випадку клієнт може надіслати інший запит на отримання списку з токеном, отриманим з помилкою 410, і сервер поверне список, починаючи з наступного ключа, але з останнього знімка, що є непослідовним з попередніми результатами списку — обʼєкти, створені, змінені або видалені після першого запиту списку, будуть включені у відповідь, поки їхні ключі знаходяться після "наступного ключа". Це поле не підтримується, коли watch дорівнює true. Клієнти можуть почати спостереження з останнього значення resourceVersion, повернутого сервером, і не пропустити жодних змін.
`fieldSelector`	string	Селектор для обмеження списку повернутих обʼєктів за їхніми полями. Стандартно — все.
`labelSelector`	string	Селектор для обмеження списку повернутих обʼєктів за їхніми мітками. Стандартно — все.
`limit`	integer	limit — це максимальна кількість відповідей для повернення у виклику списку. Якщо існує більше елементів, сервер встановить поле `continue` у метаданих списку на значення, яке можна використовувати з тим самим початковим запитом для отримання наступного набору результатів. Встановлення ліміту може повернути менше запитаної кількості елементів (до нуля елементів), якщо всі запитані обʼєкти відфільтровані, і клієнти повинні використовувати наявність поля continue для визначення наявності додаткових результатів. Сервери можуть не підтримувати аргумент limit і повертатимуть усі доступні результати. Якщо limit вказано, а поле continue порожнє, клієнти можуть припустити, що додаткові результати відсутні. Це поле не підтримується, якщо watch дорівнює true. Гарантується, що обʼєкти, повернуті при використанні continue, будуть ідентичними одноразовому виклику списку без ліміту — тобто жодні обʼєкти, створені, змінені або видалені після першого запиту, не будуть включені у наступні запити з continue. Це іноді називається послідовним знімком і забезпечує клієнту, який використовує limit для отримання менших частин дуже великого результату, можливість побачити всі можливі обʼєкти. Якщо обʼєкти оновлюються під час розбитого на частини списку, повертається версія обʼєкта, яка була на момент розрахунку першого результату списку.
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).
`resourceVersion`	string	resourceVersion встановлює обмеження щодо того, з яких версій ресурсу може обслуговуватися запит. Детальніше: https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions. Стандартно — не встановлено
`resourceVersionMatch`	string	resourceVersionMatch визначає, як resourceVersion застосовується до викликів списку. Наполегливо рекомендується встановлювати resourceVersionMatch для викликів списку, де встановлено resourceVersion. Детальніше: https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions. Стандартно — не встановлено
`sendInitialEvents`	boolean	Параметр `sendInitialEvents=true` може бути встановлений разом із `watch=true`. У цьому випадку потік спостереження почнеться із синтетичних подій, щоб відобразити поточний стан обʼєктів у колекції. Після того, як усі такі події буде надіслано, буде надіслано синтетичну подію "Bookmark". Ця подія повідомить ResourceVersion (RV), що відповідає набору обʼєктів, і буде позначена анотацією `"k8s.io/initial-events-end": "true"`. Далі потік спостереження продовжиться як зазвичай, надсилаючи події, що відповідають змінам (після цієї RV) обʼєктів, за якими ведеться спостереження. Коли встановлено параметр `sendInitialEvents`, ми вимагаємо, щоб також був встановлений параметр `resourceVersionMatch`. Семантика запиту на спостереження така: - `resourceVersionMatch` = NotOlderThan інтерпретується як "дані принаймні такі ж нові, як наданий `resourceVersion`", і подія-bookmark надсилається, коли стан синхронізовано до `resourceVersion`, принаймні так само свіжого, як наданий у ListOptions. Якщо `resourceVersion` не встановлено, це інтерпретується як "consistent read", і подія-bookmark надсилається, коли стан синхронізовано принаймні до моменту початку обробки запиту. - `resourceVersionMatch`, встановлений у будь-яке інше значення або не встановлений, повертає помилку Invalid. За замовчуванням true, якщо `resourceVersion=""` або `resourceVersion="0"` (з міркувань зворотної сумісності), і false в інших випадках.
`shardSelector`	string	shardSelector обмежує список повернутих обʼєктів за допомогою виразу селектора шардів на основі CEL. Формат використовує функцію shardRange() разом із \|\| (логічне АБО) для вказання одного або кількох діапазонів хешів: shardRange(object.metadata.uid, '0x0', '0x8000000000000000') shardRange(object.metadata.uid, '0x0', '0x8000000000000000') \|\| shardRange(object.metadata.uid, '0x8000000000000000', '0x10000000000000000') Шляхи до полів використовують синтаксис із коренем в обʼєкті в стилі CEL (наприклад, "object.metadata.uid"), а НЕ формат fieldSelector ("metadata.uid"). Наразі підтримуються такі шляхи: - object.metadata.uid - object.metadata.namespace hexStart і hexEnd є рядковими літералами CEL в одинарних лапках з префіксом '0x', що визначають інклюзивну нижню та ексклюзивну верхню межі в 64-бітному просторі хешів FNV-1a. Повний діапазон — [0x0, 0x10000000000000000), де ексклюзивна верхня межа дорівнює 2^64. Приклади: Розділення на 2 шарди: шард 0: shardRange(object.metadata.uid, '0x0000000000000000', '0x8000000000000000') шард 1: shardRange(object.metadata.uid, '0x8000000000000000', '0x10000000000000000') Розділення на 4 шарди: шард 0: shardRange(object.metadata.uid, '0x0000000000000000', '0x4000000000000000') шард 1: shardRange(object.metadata.uid, '0x4000000000000000', '0x8000000000000000') шард 2: shardRange(object.metadata.uid, '0x8000000000000000', '0xc000000000000000') шард 3: shardRange(object.metadata.uid, '0xc000000000000000', '0x10000000000000000') Це альфа-поле і вимагає увімкнення функціональної можливості ShardedListAndWatch.
`timeoutSeconds`	integer	Час очікування для виклику списку/спостереження. Це обмежує тривалість виклику, незалежно від активності чи бездіяльності.
`watch`	boolean	Спостерігати за змінами описаних ресурсів і повертати їх як потік сповіщень про додавання, оновлення та видалення. Вкажіть resourceVersion.

Відповідь

Статус	Опис	Відповідь
200	OK	WatchEvent

`get` Watch List

HTTP Запит

GET /apis/lifecycle.k8s.io/v1alpha1/watch/namespaces/{namespace}/evictions

Параметри шляху

Назва	Тип	Опис
`namespace`	string	назва обʼєкта та область автентифікації, наприклад для команд та проєктів

Параметри запиту

Назва	Тип	Опис
`allowWatchBookmarks`	boolean	Дозволяє запити подій спостереження з типом "BOOKMARK". Сервери, які не реалізовують закладки, можуть ігнорувати цей прапорець, а закладки надсилаються на розсуд сервера. Клієнти не повинні припускати, що закладки повертаються через будь-який конкретний інтервал, а також не повинні припускати, що сервер надсилатиме будь-яку подію BOOKMARK під час сеансу. Якщо це не спостереження, це поле ігнорується.
`continue`	string	Параметр continue слід встановлювати при отриманні додаткових результатів від сервера. Оскільки це значення визначається сервером, клієнти можуть використовувати значення continue лише з попереднього результату запиту з ідентичними параметрами запиту (крім значення continue), і сервер може відхилити значення continue, яке він не визнає. Якщо вказане значення continue більше не дійсне через термін дії (зазвичай від пʼяти до пʼятнадцяти хвилин) або зміну конфігурації на сервері, сервер поверне помилку 410 ResourceExpired разом з токеном continue. Якщо клієнту потрібен послідовний список, його необхідно перезапустити без поля continue. В іншому випадку клієнт може надіслати інший запит на отримання списку з токеном, отриманим з помилкою 410, і сервер поверне список, починаючи з наступного ключа, але з останнього знімка, що є непослідовним з попередніми результатами списку — обʼєкти, створені, змінені або видалені після першого запиту списку, будуть включені у відповідь, поки їхні ключі знаходяться після "наступного ключа". Це поле не підтримується, коли watch дорівнює true. Клієнти можуть почати спостереження з останнього значення resourceVersion, повернутого сервером, і не пропустити жодних змін.
`fieldSelector`	string	Селектор для обмеження списку повернутих обʼєктів за їхніми полями. Стандартно — все.
`labelSelector`	string	Селектор для обмеження списку повернутих обʼєктів за їхніми мітками. Стандартно — все.
`limit`	integer	limit — це максимальна кількість відповідей для повернення у виклику списку. Якщо існує більше елементів, сервер встановить поле `continue` у метаданих списку на значення, яке можна використовувати з тим самим початковим запитом для отримання наступного набору результатів. Встановлення ліміту може повернути менше запитаної кількості елементів (до нуля елементів), якщо всі запитані обʼєкти відфільтровані, і клієнти повинні використовувати наявність поля continue для визначення наявності додаткових результатів. Сервери можуть не підтримувати аргумент limit і повертатимуть усі доступні результати. Якщо limit вказано, а поле continue порожнє, клієнти можуть припустити, що додаткові результати відсутні. Це поле не підтримується, якщо watch дорівнює true. Гарантується, що обʼєкти, повернуті при використанні continue, будуть ідентичними одноразовому виклику списку без ліміту — тобто жодні обʼєкти, створені, змінені або видалені після першого запиту, не будуть включені у наступні запити з continue. Це іноді називається послідовним знімком і забезпечує клієнту, який використовує limit для отримання менших частин дуже великого результату, можливість побачити всі можливі обʼєкти. Якщо обʼєкти оновлюються під час розбитого на частини списку, повертається версія обʼєкта, яка була на момент розрахунку першого результату списку.
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).
`resourceVersion`	string	resourceVersion встановлює обмеження щодо того, з яких версій ресурсу може обслуговуватися запит. Детальніше: https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions. Стандартно — не встановлено
`resourceVersionMatch`	string	resourceVersionMatch визначає, як resourceVersion застосовується до викликів списку. Наполегливо рекомендується встановлювати resourceVersionMatch для викликів списку, де встановлено resourceVersion. Детальніше: https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions. Стандартно — не встановлено
`sendInitialEvents`	boolean	Параметр `sendInitialEvents=true` може бути встановлений разом із `watch=true`. У цьому випадку потік спостереження почнеться із синтетичних подій, щоб відобразити поточний стан обʼєктів у колекції. Після того, як усі такі події буде надіслано, буде надіслано синтетичну подію "Bookmark". Ця подія повідомить ResourceVersion (RV), що відповідає набору обʼєктів, і буде позначена анотацією `"k8s.io/initial-events-end": "true"`. Далі потік спостереження продовжиться як зазвичай, надсилаючи події, що відповідають змінам (після цієї RV) обʼєктів, за якими ведеться спостереження. Коли встановлено параметр `sendInitialEvents`, ми вимагаємо, щоб також був встановлений параметр `resourceVersionMatch`. Семантика запиту на спостереження така: - `resourceVersionMatch` = NotOlderThan інтерпретується як "дані принаймні такі ж нові, як наданий `resourceVersion`", і подія-bookmark надсилається, коли стан синхронізовано до `resourceVersion`, принаймні так само свіжого, як наданий у ListOptions. Якщо `resourceVersion` не встановлено, це інтерпретується як "consistent read", і подія-bookmark надсилається, коли стан синхронізовано принаймні до моменту початку обробки запиту. - `resourceVersionMatch`, встановлений у будь-яке інше значення або не встановлений, повертає помилку Invalid. За замовчуванням true, якщо `resourceVersion=""` або `resourceVersion="0"` (з міркувань зворотної сумісності), і false в інших випадках.
`shardSelector`	string	shardSelector обмежує список повернутих обʼєктів за допомогою виразу селектора шардів на основі CEL. Формат використовує функцію shardRange() разом із \|\| (логічне АБО) для вказання одного або кількох діапазонів хешів: shardRange(object.metadata.uid, '0x0', '0x8000000000000000') shardRange(object.metadata.uid, '0x0', '0x8000000000000000') \|\| shardRange(object.metadata.uid, '0x8000000000000000', '0x10000000000000000') Шляхи до полів використовують синтаксис із коренем в обʼєкті в стилі CEL (наприклад, "object.metadata.uid"), а НЕ формат fieldSelector ("metadata.uid"). Наразі підтримуються такі шляхи: - object.metadata.uid - object.metadata.namespace hexStart і hexEnd є рядковими літералами CEL в одинарних лапках з префіксом '0x', що визначають інклюзивну нижню та ексклюзивну верхню межі в 64-бітному просторі хешів FNV-1a. Повний діапазон — [0x0, 0x10000000000000000), де ексклюзивна верхня межа дорівнює 2^64. Приклади: Розділення на 2 шарди: шард 0: shardRange(object.metadata.uid, '0x0000000000000000', '0x8000000000000000') шард 1: shardRange(object.metadata.uid, '0x8000000000000000', '0x10000000000000000') Розділення на 4 шарди: шард 0: shardRange(object.metadata.uid, '0x0000000000000000', '0x4000000000000000') шард 1: shardRange(object.metadata.uid, '0x4000000000000000', '0x8000000000000000') шард 2: shardRange(object.metadata.uid, '0x8000000000000000', '0xc000000000000000') шард 3: shardRange(object.metadata.uid, '0xc000000000000000', '0x10000000000000000') Це альфа-поле і вимагає увімкнення функціональної можливості ShardedListAndWatch.
`timeoutSeconds`	integer	Час очікування для виклику списку/спостереження. Це обмежує тривалість виклику, незалежно від активності чи бездіяльності.
`watch`	boolean	Спостерігати за змінами описаних ресурсів і повертати їх як потік сповіщень про додавання, оновлення та видалення. Вкажіть resourceVersion.

Відповідь

Статус	Опис	Відповідь
200	OK	WatchEvent

`get` Watch List All Namespaces

HTTP Запит

GET /apis/lifecycle.k8s.io/v1alpha1/watch/evictions

Параметри запиту

Назва	Тип	Опис
`allowWatchBookmarks`	boolean	Дозволяє запити подій спостереження з типом "BOOKMARK". Сервери, які не реалізовують закладки, можуть ігнорувати цей прапорець, а закладки надсилаються на розсуд сервера. Клієнти не повинні припускати, що закладки повертаються через будь-який конкретний інтервал, а також не повинні припускати, що сервер надсилатиме будь-яку подію BOOKMARK під час сеансу. Якщо це не спостереження, це поле ігнорується.
`continue`	string	Параметр continue слід встановлювати при отриманні додаткових результатів від сервера. Оскільки це значення визначається сервером, клієнти можуть використовувати значення continue лише з попереднього результату запиту з ідентичними параметрами запиту (крім значення continue), і сервер може відхилити значення continue, яке він не визнає. Якщо вказане значення continue більше не дійсне через термін дії (зазвичай від пʼяти до пʼятнадцяти хвилин) або зміну конфігурації на сервері, сервер поверне помилку 410 ResourceExpired разом з токеном continue. Якщо клієнту потрібен послідовний список, його необхідно перезапустити без поля continue. В іншому випадку клієнт може надіслати інший запит на отримання списку з токеном, отриманим з помилкою 410, і сервер поверне список, починаючи з наступного ключа, але з останнього знімка, що є непослідовним з попередніми результатами списку — обʼєкти, створені, змінені або видалені після першого запиту списку, будуть включені у відповідь, поки їхні ключі знаходяться після "наступного ключа". Це поле не підтримується, коли watch дорівнює true. Клієнти можуть почати спостереження з останнього значення resourceVersion, повернутого сервером, і не пропустити жодних змін.
`fieldSelector`	string	Селектор для обмеження списку повернутих обʼєктів за їхніми полями. Стандартно — все.
`labelSelector`	string	Селектор для обмеження списку повернутих обʼєктів за їхніми мітками. Стандартно — все.
`limit`	integer	limit — це максимальна кількість відповідей для повернення у виклику списку. Якщо існує більше елементів, сервер встановить поле `continue` у метаданих списку на значення, яке можна використовувати з тим самим початковим запитом для отримання наступного набору результатів. Встановлення ліміту може повернути менше запитаної кількості елементів (до нуля елементів), якщо всі запитані обʼєкти відфільтровані, і клієнти повинні використовувати наявність поля continue для визначення наявності додаткових результатів. Сервери можуть не підтримувати аргумент limit і повертатимуть усі доступні результати. Якщо limit вказано, а поле continue порожнє, клієнти можуть припустити, що додаткові результати відсутні. Це поле не підтримується, якщо watch дорівнює true. Гарантується, що обʼєкти, повернуті при використанні continue, будуть ідентичними одноразовому виклику списку без ліміту — тобто жодні обʼєкти, створені, змінені або видалені після першого запиту, не будуть включені у наступні запити з continue. Це іноді називається послідовним знімком і забезпечує клієнту, який використовує limit для отримання менших частин дуже великого результату, можливість побачити всі можливі обʼєкти. Якщо обʼєкти оновлюються під час розбитого на частини списку, повертається версія обʼєкта, яка була на момент розрахунку першого результату списку.
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).
`resourceVersion`	string	resourceVersion встановлює обмеження щодо того, з яких версій ресурсу може обслуговуватися запит. Детальніше: https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions. Стандартно — не встановлено
`resourceVersionMatch`	string	resourceVersionMatch визначає, як resourceVersion застосовується до викликів списку. Наполегливо рекомендується встановлювати resourceVersionMatch для викликів списку, де встановлено resourceVersion. Детальніше: https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions. Стандартно — не встановлено
`sendInitialEvents`	boolean	Параметр `sendInitialEvents=true` може бути встановлений разом із `watch=true`. У цьому випадку потік спостереження почнеться із синтетичних подій, щоб відобразити поточний стан обʼєктів у колекції. Після того, як усі такі події буде надіслано, буде надіслано синтетичну подію "Bookmark". Ця подія повідомить ResourceVersion (RV), що відповідає набору обʼєктів, і буде позначена анотацією `"k8s.io/initial-events-end": "true"`. Далі потік спостереження продовжиться як зазвичай, надсилаючи події, що відповідають змінам (після цієї RV) обʼєктів, за якими ведеться спостереження. Коли встановлено параметр `sendInitialEvents`, ми вимагаємо, щоб також був встановлений параметр `resourceVersionMatch`. Семантика запиту на спостереження така: - `resourceVersionMatch` = NotOlderThan інтерпретується як "дані принаймні такі ж нові, як наданий `resourceVersion`", і подія-bookmark надсилається, коли стан синхронізовано до `resourceVersion`, принаймні так само свіжого, як наданий у ListOptions. Якщо `resourceVersion` не встановлено, це інтерпретується як "consistent read", і подія-bookmark надсилається, коли стан синхронізовано принаймні до моменту початку обробки запиту. - `resourceVersionMatch`, встановлений у будь-яке інше значення або не встановлений, повертає помилку Invalid. За замовчуванням true, якщо `resourceVersion=""` або `resourceVersion="0"` (з міркувань зворотної сумісності), і false в інших випадках.
`shardSelector`	string	shardSelector обмежує список повернутих обʼєктів за допомогою виразу селектора шардів на основі CEL. Формат використовує функцію shardRange() разом із \|\| (логічне АБО) для вказання одного або кількох діапазонів хешів: shardRange(object.metadata.uid, '0x0', '0x8000000000000000') shardRange(object.metadata.uid, '0x0', '0x8000000000000000') \|\| shardRange(object.metadata.uid, '0x8000000000000000', '0x10000000000000000') Шляхи до полів використовують синтаксис із коренем в обʼєкті в стилі CEL (наприклад, "object.metadata.uid"), а НЕ формат fieldSelector ("metadata.uid"). Наразі підтримуються такі шляхи: - object.metadata.uid - object.metadata.namespace hexStart і hexEnd є рядковими літералами CEL в одинарних лапках з префіксом '0x', що визначають інклюзивну нижню та ексклюзивну верхню межі в 64-бітному просторі хешів FNV-1a. Повний діапазон — [0x0, 0x10000000000000000), де ексклюзивна верхня межа дорівнює 2^64. Приклади: Розділення на 2 шарди: шард 0: shardRange(object.metadata.uid, '0x0000000000000000', '0x8000000000000000') шард 1: shardRange(object.metadata.uid, '0x8000000000000000', '0x10000000000000000') Розділення на 4 шарди: шард 0: shardRange(object.metadata.uid, '0x0000000000000000', '0x4000000000000000') шард 1: shardRange(object.metadata.uid, '0x4000000000000000', '0x8000000000000000') шард 2: shardRange(object.metadata.uid, '0x8000000000000000', '0xc000000000000000') шард 3: shardRange(object.metadata.uid, '0xc000000000000000', '0x10000000000000000') Це альфа-поле і вимагає увімкнення функціональної можливості ShardedListAndWatch.
`timeoutSeconds`	integer	Час очікування для виклику списку/спостереження. Це обмежує тривалість виклику, незалежно від активності чи бездіяльності.
`watch`	boolean	Спостерігати за змінами описаних ресурсів і повертати їх як потік сповіщень про додавання, оновлення та видалення. Вкажіть resourceVersion.

Відповідь

Статус	Опис	Відповідь
200	OK	WatchEvent

`patch` Patch Status

HTTP Запит

PATCH /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictions/{name}/status

Параметри шляху

Назва	Тип	Опис
`name`	string	назва обʼєкта Eviction
`namespace`	string	назва обʼєкта та область автентифікації, наприклад для команд та проєктів

Параметри запиту

Назва	Тип	Опис
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).
`dryRun`	string	Коли параметр присутній, це вказує, що зміни не повинні зберігатися. Неправильна або нерозпізнана директива dryRun призведе до помилки та припинення обробки запиту. Дійсні значення: All: всі етапи dry run будуть виконані
`fieldManager`	string	fieldManager є імʼям, повʼязаним з а́ктором або сутністю, яка вносить ці зміни. Значення повинно бути менше або дорівнювати 128 символам і містити лише друковані символи, як визначено в https://golang.org/pkg/unicode/#IsPrint. Це поле є обовʼязковим для запитів apply (application/apply-patch), але необовʼязковим для типів patch, що не є apply (JsonPatch, MergePatch, StrategicMergePatch).
`fieldValidation`	string	fieldValidation інструктує сервер, як обробляти обʼєкти в запиті (POST/PUT/PATCH), що містять невідомі або дубльовані поля. Дійсні значення: Ignore: Ігнорує всі невідомі поля, які без попередження видаляються з обʼєкта, а також ігнорує всі дублікати полів, крім останнього, на які натрапляє декодер. Це стандартна поведінка до v1.23. Warn: Надсилає попередження через стандартний заголовок відповіді для кожного невідомого поля, яке видаляється з обʼєкта, і для кожного дубльованого поля, яке зустрічається. Запит все ще буде успішним, якщо немає інших помилок, і буде зберігатися лише останнє з будь-яких дубльованих полів. Це стандартна поведінка у v1.23+ Strict: У цьому випадку запит завершиться з помилкою BadRequest, якщо з обʼєкта будуть вилучені невідомі поля або якщо будуть виявлені дублікати полів. Помилка, що повертається сервером, міститиме всі виявлені невідомі та дубльовані поля.
`force`	boolean	Force здійснює "примусове" виконання запитів Apply. Це означає, що користувач повторно отримає конфліктні поля, що належать іншим людям. Прапорець Force повинен бути не встановлений для запитів patch, що не є apply.

Параметри тіла запиту

Назва	Тип	Опис
`body`	Patch

Відповідь

Статус	Опис	Відповідь
200	OK	Eviction
201	Created	Eviction

`get` Read Status

HTTP Запит

GET /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictions/{name}/status

Параметри шляху

Назва	Тип	Опис
`name`	string	назва обʼєкта Eviction
`namespace`	string	назва обʼєкта та область автентифікації, наприклад для команд та проєктів

Параметри запиту

Назва	Тип	Опис
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).

Відповідь

Статус	Опис	Відповідь
200	OK	Eviction

`put` Replace Status

HTTP Запит

PUT /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictions/{name}/status

Параметри шляху

Назва	Тип	Опис
`name`	string	назва обʼєкта Eviction
`namespace`	string	назва обʼєкта та область автентифікації, наприклад для команд та проєктів

Параметри запиту

Назва	Тип	Опис
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).
`dryRun`	string	Коли параметр присутній, це вказує, що зміни не повинні зберігатися. Неправильна або нерозпізнана директива dryRun призведе до помилки та припинення обробки запиту. Дійсні значення: All: всі етапи dry run будуть виконані
`fieldManager`	string	fieldManager є імʼям, повʼязаним з а́ктором або сутністю, яка вносить ці зміни. Значення повинно бути менше або дорівнювати 128 символам і містити лише друковані символи, як визначено в https://golang.org/pkg/unicode/#IsPrint.
`fieldValidation`	string	fieldValidation інструктує сервер, як обробляти обʼєкти в запиті (POST/PUT/PATCH), що містять невідомі або дубльовані поля. Дійсні значення: Ignore: Ігнорує всі невідомі поля, які без попередження видаляються з обʼєкта, а також ігнорує всі дублікати полів, крім останнього, на які натрапляє декодер. Це стандартна поведінка до v1.23. Warn: Надсилає попередження через стандартний заголовок відповіді для кожного невідомого поля, яке видаляється з обʼєкта, і для кожного дубльованого поля, яке зустрічається. Запит все ще буде успішним, якщо немає інших помилок, і буде зберігатися лише останнє з будь-яких дубльованих полів. Це стандартна поведінка у v1.23+ Strict: У цьому випадку запит завершиться з помилкою BadRequest, якщо з обʼєкта будуть вилучені невідомі поля або якщо будуть виявлені дублікати полів. Помилка, що повертається сервером, міститиме всі виявлені невідомі та дубльовані поля.

Параметри тіла запиту

Назва	Тип	Опис
`body`	Eviction

Відповідь

Статус	Опис	Відповідь
200	OK	Eviction
201	Created	Eviction

Востаннє змінено September 03, 2026 at 5:28 PM PST: [uk] Ukrainian translation (all-in-one) (2fedabf8e5)

Eviction

Eviction

EvictionSpec

EvictionStatus

EvictionList

EvictionPodReference

EvictionTarget

Requester

ResponderStatus

TargetResponder

Операції

post Create

HTTP Запит

Параметри шляху

Параметри запиту

Параметри тіла запиту

Відповідь

patch Patch

HTTP Запит

Параметри шляху

Параметри запиту

Параметри тіла запиту

Відповідь

put Replace

HTTP Запит

Параметри шляху

Параметри запиту

Параметри тіла запиту

Відповідь

delete Delete

HTTP Запит

Параметри шляху

Параметри запиту

Параметри тіла запиту

Відповідь

delete Delete Collection

HTTP Запит

Параметри шляху

Параметри запиту

Параметри тіла запиту

Відповідь

get Read

HTTP Запит

Параметри шляху

Параметри запиту

Відповідь

get List

HTTP Запит

Параметри шляху

Параметри запиту

Відповідь

get List All Namespaces

HTTP Запит

Параметри запиту

Відповідь

get Watch

HTTP Запит

Параметри шляху

Параметри запиту

Відповідь

get Watch List

HTTP Запит

Параметри шляху

Параметри запиту

Відповідь

get Watch List All Namespaces

HTTP Запит

Параметри запиту

Відповідь

patch Patch Status

HTTP Запит

Параметри шляху

Параметри запиту

Параметри тіла запиту

Відповідь

get Read Status

HTTP Запит

Параметри шляху

Параметри запиту

Відповідь

`post` Create

`patch` Patch

`put` Replace

`delete` Delete

`delete` Delete Collection

`get` Read

`get` List

`get` List All Namespaces

`get` Watch

`get` Watch List

`get` Watch List All Namespaces

`patch` Patch Status

`get` Read Status

`put` Replace Status