EvictionRequest визначає запит, який має призвести до коректного виселення .spec.target (наприклад, завершення поду).
Контролер evictionrequest відстежує наміри всіх запитів EvictionRequest і перетворює їх на об’єкти Eviction.
Існує звʼязок «багато-до-багатьох» між EvictionRequest та Eviction загалом. І «багато-до-одного», якщо ціллю є под.
Якщо всі заявники відкликують свій намір виселення для спільної цілі, виселення буде скасовано. Видалення EvictionRequest також зараховується як відкликання. Після видалення всіх EvictionRequest для певної цілі відповідні Eviction врешті-решт будуть прибрані збирачем сміття.
apiVersion: lifecycle.k8s.io/v1alpha1
import "k8s.io/api/lifecycle/v1alpha1"
EvictionRequest визначає запит, який має призвести до коректного виселення .spec.target (наприклад, завершення поду).
Контролер evictionrequest відстежує наміри всіх запитів EvictionRequest і перетворює їх на об’єкти Eviction.
Існує звʼязок «багато-до-багатьох» між EvictionRequest та Eviction загалом. І «багато-до-одного», якщо ціллю є под.
Якщо всі заявники відкликують свій намір виселення для спільної цілі, виселення буде скасовано. Видалення EvictionRequest також зараховується як відкликання. Після видалення всіх EvictionRequest для певної цілі відповідні Eviction врешті-решт будуть прибрані збирачем сміття.
| Поле | Опис |
|---|---|
apiVersionstring | apiVersion визначає версію схеми цього представлення обʼєкта. Сервери повинні конвертувати розпізнані схеми до останнього внутрішнього значення і можуть відхиляти нерозпізнані значення. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
kindstring | kind визначає тип REST-ресурсу, який представляє цей обʼєкт. Сервери можуть визначати це з точки доступу, до якої клієнт надсилає запити. Не може бути оновлено. У CamelCase. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
metadataObjectMeta | Стандартні метадані обʼєкта. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata. |
spec *EvictionRequestSpec | spec визначає специфікацію запиту на виселення. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status. |
statusEvictionRequestStatus | status представляє останній спостережений стан запиту на виселення. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status. |
EvictionRequestSpec — це специфікація EvictionRequest.
| Поле | Опис |
|---|---|
intent *string | intent визначає дію, яку слід виконати для зазначеного обʼєкта.
|
requester *string | requester дозволяє ідентифікувати сутність, яка запросила виселення цільового обʼєкта. Має бути дійсним ключем з доменним префіксом (наприклад, "acme.io/foo"). Імена доменів *.k8s.io та *.kubernetes.io зарезервовані. Це поле є обовʼязковим і незмінним. |
target *EvictionRequestTarget | target містить посилання на обʼєкт (наприклад, под), який слід виселити. Це поле є обовʼязковим і незмінним. |
EvictionRequestStatus представляє останній спостережуваний статус запиту на виселення.
| Поле | Опис |
|---|---|
conditionsCondition array patch strategy: злиття за ключем type | conditions містять інформацію про запит на виселення. Специфічні для EvictionRequest умови: TargetEvicted або Failed (керуються evictionrequest-controller).
|
observedGenerationinteger | observedGeneration — це .metadata.generation запиту EvictionRequest, спостережуваний evictionrequest-controller. Значення спостережуваного покоління не може бути відʼємним і може лише збільшуватися. Мінімальне значення — 1. Це поле керується evictionrequest-controller. |
EvictionRequestList містить список ресурсів EvictionRequest.
| Поле | Опис |
|---|---|
apiVersionstring | apiVersion визначає версію схеми цього представлення обʼєкта. Сервери повинні конвертувати розпізнані схеми до останнього внутрішнього значення і можуть відхиляти нерозпізнані значення. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
items *EvictionRequest array | items — це список обʼєктів EvictionRequest. |
kindstring | kind визначає тип REST-ресурсу, який представляє цей обʼєкт. Сервери можуть визначати це з точки доступу, до якої клієнт надсилає запити. Не може бути оновлено. У CamelCase. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
metadataListMeta | Стандартні метадані списку. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata |
EvictionRequestPodReference містить достатньо інформації для розташування підсиланного поду в межах того самого простору назв.
| Поле | Опис |
|---|---|
name *string | name цілі. Це поле є обовʼязковим. |
uid *string | uid цілі. Його можна знайти в .metadata.uid цілі; це UUID у нижньому регістрі у форматі 8-4-4-4-12. Це поле є обовʼязковим. |
EvictionRequestTarget містить посилання на обʼєкт, який слід виселити.
| Поле | Опис |
|---|---|
podEvictionRequestPodReference | pod посилається на под, який підлягає виселенню/завершенню. Поди, які є частиною PodGroup (встановлено .spec.schedulingGroup), не підтримуються. |
post CreatePOST /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictionrequests
| Назва | Тип | Опис |
|---|---|---|
namespace | string | назва обʼєкта та область автентифікації, наприклад для команд та проєктів |
| Назва | Тип | Опис |
|---|---|---|
pretty | string | Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядача або інструмент командного рядка для роботи з HTTP (curl та wget). |
dryRun | string | Коли параметр присутній, це вказує, що зміни не повинні зберігатися. Неправильна або нерозпізнана директива dryRun призведе до помилки та припинення обробки запиту. Дійсні значення:
|
fieldManager | string | fieldManager є імʼям, повʼязаним з а́ктором або сутністю, яка вносить ці зміни. Значення повинно бути менше або дорівнювати 128 символам і містити лише друковані символи, як визначено в https://golang.org/pkg/unicode/#IsPrint. |
fieldValidation | string | fieldValidation інструктує сервер, як обробляти обʼєкти в запиті (POST/PUT/PATCH), що містять невідомі або дубльовані поля. Дійсні значення:
|
| Назва | Тип | Опис |
|---|---|---|
body | EvictionRequest |
| Статус | Опис | Відповідь |
|---|---|---|
| 200 | OK | EvictionRequest |
| 201 | Created | EvictionRequest |
| 202 | Accepted | EvictionRequest |
patch PatchPATCH /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictionrequests/{name}
| Назва | Тип | Опис |
|---|---|---|
name | string | назва обʼєкта EvictionRequest |
namespace | string | назва обʼєкта та область автентифікації, наприклад для команд та проєктів |
| Назва | Тип | Опис |
|---|---|---|
pretty | string | Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядача або інструмент командного рядка для роботи з HTTP (curl та wget). |
dryRun | string | Коли параметр присутній, це вказує, що зміни не повинні зберігатися. Неправильна або нерозпізнана директива dryRun призведе до помилки та припинення обробки запиту. Дійсні значення:
|
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), що містять невідомі або дубльовані поля. Дійсні значення:
|
force | boolean | Force здійснює "примусове" виконання запитів Apply. Це означає, що користувач повторно отримає конфліктні поля, що належать іншим людям. Прапорець Force повинен бути не встановлений для запитів patch, що не є apply. |
| Назва | Тип | Опис |
|---|---|---|
body | Patch |
| Статус | Опис | Відповідь |
|---|---|---|
| 200 | OK | EvictionRequest |
| 201 | Created | EvictionRequest |
put ReplacePUT /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictionrequests/{name}
| Назва | Тип | Опис |
|---|---|---|
name | string | назва обʼєкта EvictionRequest |
namespace | string | назва обʼєкта та область автентифікації, наприклад для команд та проєктів |
| Назва | Тип | Опис |
|---|---|---|
pretty | string | Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядача або інструмент командного рядка для роботи з HTTP (curl та wget). |
dryRun | string | Коли параметр присутній, це вказує, що зміни не повинні зберігатися. Неправильна або нерозпізнана директива dryRun призведе до помилки та припинення обробки запиту. Дійсні значення:
|
fieldManager | string | fieldManager є імʼям, повʼязаним з а́ктором або сутністю, яка вносить ці зміни. Значення повинно бути менше або дорівнювати 128 символам і містити лише друковані символи, як визначено в https://golang.org/pkg/unicode/#IsPrint. |
fieldValidation | string | fieldValidation інструктує сервер, як обробляти обʼєкти в запиті (POST/PUT/PATCH), що містять невідомі або дубльовані поля. Дійсні значення:
|
| Назва | Тип | Опис |
|---|---|---|
body | EvictionRequest |
| Статус | Опис | Відповідь |
|---|---|---|
| 200 | OK | EvictionRequest |
| 201 | Created | EvictionRequest |
delete DeleteDELETE /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictionrequests/{name}
| Назва | Тип | Опис |
|---|---|---|
name | string | назва обʼєкта EvictionRequest |
namespace | string | назва обʼєкта та область автентифікації, наприклад для команд та проєктів |
| Назва | Тип | Опис |
|---|---|---|
pretty | string | Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядача або інструмент командного рядка для роботи з HTTP (curl та wget). |
dryRun | string | Коли параметр присутній, це вказує, що зміни не повинні зберігатися. Неправильна або нерозпізнана директива dryRun призведе до помилки та припинення обробки запиту. Дійсні значення:
|
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 CollectionDELETE /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictionrequests
| Назва | Тип | Опис |
|---|---|---|
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 призведе до помилки та припинення обробки запиту. Дійсні значення:
|
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 ReadGET /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictionrequests/{name}
| Назва | Тип | Опис |
|---|---|---|
name | string | назва обʼєкта EvictionRequest |
namespace | string | назва обʼєкта та область автентифікації, наприклад для команд та проєктів |
| Назва | Тип | Опис |
|---|---|---|
pretty | string | Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядача або інструмент командного рядка для роботи з HTTP (curl та wget). |
| Статус | Опис | Відповідь |
|---|---|---|
| 200 | OK | EvictionRequest |
get ListGET /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictionrequests
| Назва | Тип | Опис |
|---|---|---|
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 | EvictionRequestList |
get List All NamespacesGET /apis/lifecycle.k8s.io/v1alpha1/evictionrequests
| Назва | Тип | Опис |
|---|---|---|
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 | EvictionRequestList |
get WatchGET /apis/lifecycle.k8s.io/v1alpha1/watch/namespaces/{namespace}/evictionrequests/{name}
| Назва | Тип | Опис |
|---|---|---|
name | string | назва обʼєкта EvictionRequest |
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 ListGET /apis/lifecycle.k8s.io/v1alpha1/watch/namespaces/{namespace}/evictionrequests
| Назва | Тип | Опис |
|---|---|---|
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 NamespacesGET /apis/lifecycle.k8s.io/v1alpha1/watch/evictionrequests
| Назва | Тип | Опис |
|---|---|---|
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 StatusPATCH /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictionrequests/{name}/status
| Назва | Тип | Опис |
|---|---|---|
name | string | назва обʼєкта EvictionRequest |
namespace | string | назва обʼєкта та область автентифікації, наприклад для команд та проєктів |
| Назва | Тип | Опис |
|---|---|---|
pretty | string | Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядача або інструмент командного рядка для роботи з HTTP (curl та wget). |
dryRun | string | Коли параметр присутній, це вказує, що зміни не повинні зберігатися. Неправильна або нерозпізнана директива dryRun призведе до помилки та припинення обробки запиту. Дійсні значення:
|
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), що містять невідомі або дубльовані поля. Дійсні значення:
|
force | boolean | Force здійснює "примусове" виконання запитів Apply. Це означає, що користувач повторно отримає конфліктні поля, що належать іншим людям. Прапорець Force повинен бути не встановлений для запитів patch, що не є apply. |
| Назва | Тип | Опис |
|---|---|---|
body | Patch |
| Статус | Опис | Відповідь |
|---|---|---|
| 200 | OK | EvictionRequest |
| 201 | Created | EvictionRequest |
get Read StatusGET /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictionrequests/{name}/status
| Назва | Тип | Опис |
|---|---|---|
name | string | назва обʼєкта EvictionRequest |
namespace | string | назва обʼєкта та область автентифікації, наприклад для команд та проєктів |
| Назва | Тип | Опис |
|---|---|---|
pretty | string | Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядача або інструмент командного рядка для роботи з HTTP (curl та wget). |
| Статус | Опис | Відповідь |
|---|---|---|
| 200 | OK | EvictionRequest |
put Replace StatusPUT /apis/lifecycle.k8s.io/v1alpha1/namespaces/{namespace}/evictionrequests/{name}/status
| Назва | Тип | Опис |
|---|---|---|
name | string | назва обʼєкта EvictionRequest |
namespace | string | назва обʼєкта та область автентифікації, наприклад для команд та проєктів |
| Назва | Тип | Опис |
|---|---|---|
pretty | string | Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядача або інструмент командного рядка для роботи з HTTP (curl та wget). |
dryRun | string | Коли параметр присутній, це вказує, що зміни не повинні зберігатися. Неправильна або нерозпізнана директива dryRun призведе до помилки та припинення обробки запиту. Дійсні значення:
|
fieldManager | string | fieldManager є імʼям, повʼязаним з а́ктором або сутністю, яка вносить ці зміни. Значення повинно бути менше або дорівнювати 128 символам і містити лише друковані символи, як визначено в https://golang.org/pkg/unicode/#IsPrint. |
fieldValidation | string | fieldValidation інструктує сервер, як обробляти обʼєкти в запиті (POST/PUT/PATCH), що містять невідомі або дубльовані поля. Дійсні значення:
|
| Назва | Тип | Опис |
|---|---|---|
body | EvictionRequest |
| Статус | Опис | Відповідь |
|---|---|---|
| 200 | OK | EvictionRequest |
| 201 | Created | EvictionRequest |