Ingress

Ingress є колекцією правил, які дозволяють вхідним зʼєднанням досягати точок доступу, визначених бекендом. Ingress можна налаштувати для надання сервісам зовнішньо доступних URL, балансування навантаження, теримінування SSL, пропозиції віртуального хостингу на основі імен тощо.

apiVersion: networking.k8s.io/v1

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

Ingress

Поле	Опис
`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
`spec` IngressSpec	spec визначає бажаний стан Ingress. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
`status` IngressStatus	status визначає поточний стан Ingress. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

IngressSpec

IngressSpec описує Ingress, який користувач бажає створити.

Поле	Опис
`defaultBackend` IngressBackend	defaultBackend є бекендом, який повинен обробляти запити, що не відповідають жодному правилу. Якщо правила не вказані, обовʼязково має бути вказаний DefaultBackend. Якщо DefaultBackend не встановлено, обробка запитів, що не відповідають жодному з правил, буде залежати від контролера Ingress.
`ingressClassName` string	ingressClassName є назвою ресурсу IngressClass у кластері. Реалізації контролера Ingress використовують це поле, щоб знати, чи повинні вони обслуговувати цей ресурс Ingress, через транзитивне з'єднання (controller -> IngressClass -> Ingress resource). Хоча анотація `kubernetes.io/ingress.class` (проста константна назва) ніколи не була формально визначена, вона широко підтримувалася контролерами Ingress для створення прямого зв'язку між контролером Ingress та ресурсами Ingress. Новостворені ресурси Ingress повинні віддавати перевагу використанню цього поля. Однак, навіть якщо анотація офіційно застаріла, з міркувань зворотної сумісності контролери Ingress все ще повинні враховувати цю анотацію, якщо вона присутня.
`rules` IngressRule array	rules є списком правил хостів, які використовуються для налаштування Ingress. Якщо не вказано або жодне правило не збігається, весь трафік надсилається до стандартного бекенду.
`tls` IngressTLS array	tls представляє конфігурацію TLS. Наразі Ingress підтримує лише один TLS-порт, 443. Якщо кілька елементів цього списку вказують різні хости, вони будуть мультиплексовані на одному порту відповідно до імені хоста, вказаного через розширення SNI TLS, якщо контролер Ingress, що обслуговує Ingress, підтримує SNI.

IngressStatus

IngressStatus описує поточний стан Ingress.

Поле	Опис
`loadBalancer` IngressLoadBalancerStatus	loadBalancer містить поточний стан балансувальника навантаження.

IngressList

IngressList є колекцією Ingress.

Поле	Опис
`apiVersion` string	APIVersion визначає версію схеми цього представлення обʼєкта. Сервери повинні конвертувати розпізнані схеми до останнього внутрішнього значення і можуть відхиляти нерозпізнані значення. Детальніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`items` * Ingress array	items є списком Ingress.
`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

HTTPIngressPath

HTTPIngressPath асоціює шлях з бекендом. Вхідні URL, що відповідають шляху, переспрямовуються до бекенду.

Поле Опис

backend *
IngressBackend backend визначає посилання на точку доступу сервісу, до якої буде перенаправлено трафік.

path
string path відповідає шляху вхідного запиту. Наразі він може містити символи, заборонені в звичайній частині "path" URL, як визначено в RFC 3986. Шляхи повинні починатися з '/' і бути присутніми при використанні PathType зі значенням "Exact" або "Prefix".

Поле	Опис
`backend` * IngressBackend	backend визначає посилання на точку доступу сервісу, до якої буде перенаправлено трафік.
`path` string	path відповідає шляху вхідного запиту. Наразі він може містити символи, заборонені в звичайній частині "path" URL, як визначено в RFC 3986. Шляхи повинні починатися з '/' і бути присутніми при використанні PathType зі значенням "Exact" або "Prefix".
`pathType` * string	pathType визначає інтерпретацію відповідності шляху. PathType може мати одне з наступних значень: Exact: Точно збігається з URL шляху. Prefix: Має збіг на основі префіксу URL шляху, розділеного '/'. Відповідність виконується по елементах шляху. Елемент шляху — це список міток у шляху, розділених символом '/'. Запит відповідає шляху p, якщо кожен p є префіксом елемента шляху запиту. Зверніть увагу, що якщо останній елемент шляху є підрядком останнього елемента шляху запиту, це не є відповідністю (наприклад, /foo/bar відповідає /foo/bar/baz, але не відповідає /foo/barbaz). ImplementationSpecific: Інтерпретація відповідності шляху залежить від IngressClass. Реалізації можуть розглядати це як окремий PathType або обробляти його ідентично до типів шляхів Prefix або Exact. Реалізації зобовʼязані підтримувати всі типи шляхів. Можливі значення enum: "Exact" відповідає URL шляху точно і з урахуванням регістру. "ImplementationSpecific" відповідність залежить від IngressClass. Реалізації можуть розглядати це як окремий PathType або обробляти його ідентично до типів шляхів Prefix або Exact. "Prefix" відповідає на основі префіксу URL шляху, розділеного '/'. Відповідність чутлива до регістру і виконується по елементах шляху. Елемент шляху - це список міток у шляху, розділених символом '/'. Запит відповідає шляху p, якщо кожен p є префіксом елемента шляху запиту. Зверніть увагу, що якщо останній елемент шляху є підрядком останнього елемента шляху запиту, це не є відповідністю (наприклад, /foo/bar відповідає /foo/bar/baz, але не відповідає /foo/barbaz). Якщо в специфікації Ingress існує кілька відповідних шляхів, пріоритет надається найдовшому відповідному шляху. Приклади: /foo/bar не має збігу з запитами до /foo/barbaz /foo/bar має збіг з запитами до /foo/bar і /foo/bar/baz /foo і /foo/ обидва мають збіг з запитами до /foo і /foo/. Якщо обидва шляхи присутні в специфікації Ingress, пріоритет надається найдовшому відповідному шляху (/foo/).

pathType *
string

pathType визначає інтерпретацію відповідності шляху. PathType може мати одне з наступних значень:

Exact: Точно збігається з URL шляху.
Prefix: Має збіг на основі префіксу URL шляху, розділеного '/'. Відповідність виконується по елементах шляху. Елемент шляху — це список міток у шляху, розділених символом '/'. Запит відповідає шляху p, якщо кожен p є префіксом елемента шляху запиту. Зверніть увагу, що якщо останній елемент шляху є підрядком останнього елемента шляху запиту, це не є відповідністю (наприклад, /foo/bar відповідає /foo/bar/baz, але не відповідає /foo/barbaz).
ImplementationSpecific: Інтерпретація відповідності шляху залежить від IngressClass. Реалізації можуть розглядати це як окремий PathType або обробляти його ідентично до типів шляхів Prefix або Exact. Реалізації зобовʼязані підтримувати всі типи шляхів.

Можливі значення enum:

"Exact" відповідає URL шляху точно і з урахуванням регістру.
"ImplementationSpecific" відповідність залежить від IngressClass. Реалізації можуть розглядати це як окремий PathType або обробляти його ідентично до типів шляхів Prefix або Exact.
"Prefix" відповідає на основі префіксу URL шляху, розділеного '/'. Відповідність чутлива до регістру і виконується по елементах шляху. Елемент шляху - це список міток у шляху, розділених символом '/'. Запит відповідає шляху p, якщо кожен p є префіксом елемента шляху запиту. Зверніть увагу, що якщо останній елемент шляху є підрядком останнього елемента шляху запиту, це не є відповідністю (наприклад, /foo/bar відповідає /foo/bar/baz, але не відповідає /foo/barbaz). Якщо в специфікації Ingress існує кілька відповідних шляхів, пріоритет надається найдовшому відповідному шляху. Приклади:
- /foo/bar не має збігу з запитами до /foo/barbaz
- /foo/bar має збіг з запитами до /foo/bar і /foo/bar/baz
- /foo і /foo/ обидва мають збіг з запитами до /foo і /foo/. Якщо обидва шляхи присутні в специфікації Ingress, пріоритет надається найдовшому відповідному шляху (/foo/).

HTTPIngressRuleValue

HTTPIngressRuleValue є списком HTTP-селекторів, що вказують на бекенди. У прикладі: http://<host>/<path>?<searchpart> -> backend, де частини URL відповідають RFC 3986, цей ресурс буде використовуватися для відповідності всьому, що знаходиться після останнього '/' і перед першим '?' або '#'.

Поле	Опис
`paths` * HTTPIngressPath array	paths є колекцією шляхів, які зіставляють запити з бекендами.

IngressBackend

IngressBackend описує всі точки доступу для заданого сервісу та порту.

Поле	Опис
`resource` TypedLocalObjectReference	resource є посиланням на інший ресурс Kubernetes у просторі імен обʼєкта Ingress. Якщо вказано resource, не можна вказувати service.Name і service.Port. Це взаємовиключне налаштування з "Service".
`service` IngressServiceBackend	service є посиланням на сервіс як бекенд. Це взаємовиключне налаштування з "Resource".

IngressLoadBalancerIngress

IngressLoadBalancerIngress представляє стан точки доступу балансувальника навантаження.

Поле	Опис
`hostname` string	hostname встановлюється для точок доступу балансувальника навантаження, які базуються на DNS.
`ip` string	ip встановлюється для точок доступу балансувальника навантаження, які базуються на IP.
`ports` IngressPortStatus array	ports надає інформацію про порти, відкриті цим балансувальником навантаження.

IngressLoadBalancerStatus

IngressLoadBalancerStatus представляє стан балансувальника навантаження.

Поле	Опис
`ingress` IngressLoadBalancerIngress array	ingress є списком, що містить точки доступу для балансувальника навантаження.

IngressPortStatus

IngressPortStatus представляє стан порту сервісу

Поле	Опис
`error` string	error використовується для запису проблеми з портом сервісу. Формат помилки повинен відповідати наступним правилам: вбудовані значення помилок повинні бути вказані в цьому файлі і вони повинні використовувати CamelCase імена специфічні для постачальника хмари значення помилок повинні мати імена, що відповідають формату foo.example.com/CamelCase
`port` * integer	port є номером порту ingress.
`protocol` * string	protocol є протоколом порту ingress. Підтримувані значення: "TCP", "UDP", "SCTP" Можливі значення enum: `"SCTP"` є протоколом SCTP. `"TCP"` є протоколом TCP. `"UDP"` є протоколом UDP.

IngressRule

IngressRule представляє правила, що зіставляють шляхи з зазначеним хостом та відповідним бекенд-сервісом. Вхідні запити спочатку оцінюються на відповідність хосту, а потім маршрутизуються до бекенду, повʼязаного з відповідним IngressRuleValue.

Поле Опис

Поле	Опис
`host` string	host є повністю кваліфікованим доменним іменем мережевого хоста, як визначено в RFC 3986. Зверніть увагу на наступні відхилення від частини "host" URI, як визначено в RFC 3986: IP-адреси не дозволені. Наразі IngressRuleValue може застосовуватися лише до IP у Spec батьківського Ingress. Роздільник `:` не враховується, оскільки порти не дозволені. Наразі порт Ingress неявно :80 для http і :443 для https. Обидва ці значення можуть змінитися в майбутньому. Вхідні запити порівнюються з host перед IngressRuleValue. Якщо host не вказано, Ingress маршрутизує весь трафік на основі зазначеного IngressRuleValue. host може бути "precise", що є доменним іменем без кінцевої крапки мережевого хоста (наприклад, "foo.bar.com"), або "wildcard", що є доменним іменем з префіксом одного символу підстановки (наприклад, ".foo.com"). Символ підстановки '' повинен зʼявлятися самостійно як перша DNS-мітка і відповідає лише одній мітці лейблу. Ви не можете мати мітку підстановки самостійно (наприклад, Host == "*"). Запити будуть порівнюватися з полем Host наступним чином: Якщо host є точним, запит відповідає цьому правилу, якщо заголовок http host дорівнює Host. Якщо host є підстановкою, запит відповідає цьому правилу, якщо заголовок http host дорівнює суфіксу (видаляючи перший лейбл) правила підстановки.
`http` HTTPIngressRuleValue

host
string

host є повністю кваліфікованим доменним іменем мережевого хоста, як визначено в RFC 3986. Зверніть увагу на наступні відхилення від частини "host" URI, як визначено в RFC 3986:

IP-адреси не дозволені. Наразі IngressRuleValue може застосовуватися лише до IP у Spec батьківського Ingress.
Роздільник : не враховується, оскільки порти не дозволені. Наразі порт Ingress неявно :80 для http і :443 для https.

Обидва ці значення можуть змінитися в майбутньому. Вхідні запити порівнюються з host перед IngressRuleValue. Якщо host не вказано, Ingress маршрутизує весь трафік на основі зазначеного IngressRuleValue. host може бути "precise", що є доменним іменем без кінцевої крапки мережевого хоста (наприклад, "foo.bar.com"), або "wildcard", що є доменним іменем з префіксом одного символу підстановки (наприклад, "*.foo.com"). Символ підстановки '*' повинен зʼявлятися самостійно як перша DNS-мітка і відповідає лише одній мітці лейблу. Ви не можете мати мітку підстановки самостійно (наприклад, Host == "*"). Запити будуть порівнюватися з полем Host наступним чином:

Якщо host є точним, запит відповідає цьому правилу, якщо заголовок http host дорівнює Host.
Якщо host є підстановкою, запит відповідає цьому правилу, якщо заголовок http host дорівнює суфіксу (видаляючи перший лейбл) правила підстановки.

http
HTTPIngressRuleValue

IngressServiceBackend

IngressServiceBackend посилається на Kubernetes Service як Backend.

Поле	Опис
`name` * string	name є посиланням на сервіс. Сервіс повинен існувати в тому ж просторі імен, що й обʼєкт Ingress.
`port` ServiceBackendPort	port є портом посилання на сервіс. Для IngressServiceBackend потрібен або імʼя порту, або номер порту.

IngressTLS

IngressTLS описує транспортний рівень безпеки, повʼязаний з ingress.

Поле Опис

hosts
string array hosts є списком хостів, включених до TLS сертифіката. Значення в цьому списку повинні відповідати іменам, використаним у tlsSecret. Стандартно використовується налаштування wildcard host для контролера балансувальника навантаження, що виконує цей Ingress, якщо не вказано інше.

secretName
string secretName є імʼям секрету, який використовується для завершення TLS трафіку на порту 443. Поле залишено необовʼязковим, щоб дозволити маршрутизацію TLS на основі лише імені хоста SNI. Якщо хост SNI у слухачі конфліктує з полем заголовка "Host", використаним у IngressRule, хост SNI використовується для завершення, а значення заголовка "Host" використовується для маршрутизації.

Поле	Опис
`hosts` string array	hosts є списком хостів, включених до TLS сертифіката. Значення в цьому списку повинні відповідати іменам, використаним у tlsSecret. Стандартно використовується налаштування wildcard host для контролера балансувальника навантаження, що виконує цей Ingress, якщо не вказано інше.
`secretName` string	secretName є імʼям секрету, який використовується для завершення TLS трафіку на порту 443. Поле залишено необовʼязковим, щоб дозволити маршрутизацію TLS на основі лише імені хоста SNI. Якщо хост SNI у слухачі конфліктує з полем заголовка "Host", використаним у IngressRule, хост SNI використовується для завершення, а значення заголовка "Host" використовується для маршрутизації.

ServiceBackendPort

ServiceBackendPort є портом сервісу, на який здійснюється посилання.

Поле	Опис
`name` string	name є імʼям порту на сервісі. Це взаємовиключне налаштування з "number".
`number` integer	number є числовим номером порту (наприклад, 80) на сервісі. Це взаємовиключне налаштування з "name".

Операції

`post` Create

HTTP Запит

POST /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses

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

Назва	Тип	Опис
`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`	Ingress

Відповідь

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

`patch` Patch

HTTP Запит

PATCH /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}

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

Назва	Тип	Опис
`name`	string	Назва Ingress
`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), але необовʼязкове для типів патчів, що не застосовуються (JsonPatch, MergePatch, StrategicMergePatch).
`fieldValidation`	string	fieldValidation інструктує сервер, як обробляти обʼєкти в запиті (POST/PUT/PATCH), що містять невідомі або дубльовані поля. Дійсні значення: Ignore: Ігнорує всі невідомі поля, які без попередження видаляються з обʼєкта, а також ігнорує всі дублікати полів, крім останнього, на які натрапляє декодер. Це стандартна поведінка до v1.23. Warn: Надсилає попередження через стандартний заголовок відповіді для кожного невідомого поля, яке видаляється з обʼєкта, і для кожного дубльованого поля, яке зустрічається. Запит все ще буде успішним, якщо немає інших помилок, і буде зберігатися лише останнє з будь-яких дубльованих полів. Це стандартна поведінка у v1.23+ Strict: У цьому випадку запит завершиться з помилкою BadRequest, якщо з обʼєкта будуть вилучені невідомі поля або якщо будуть виявлені дублікати полів. Помилка, що повертається сервером, міститиме всі виявлені невідомі та дубльовані поля.
`force`	boolean	Force має на меті "примусово" застосовувати запити Apply. Це означає, що користувач повторно отримає конфліктні поля, що належать іншим користувачам. Прапорець Force повинен бути скасований для запитів, що не є патчами apply.

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

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

Відповідь

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

`put` Replace

HTTP Запит

PUT /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}

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

Назва	Тип	Опис
`name`	string	Назва Ingress
`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`	Ingress

Відповідь

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

`delete` Delete

HTTP Запит

DELETE /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}

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

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

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

Назва	Тип	Опис
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).
`dryRun`	string	Коли параметр присутній, це вказує, що зміни не повинні зберігатися. Неправильна або нерозпізнана директива dryRun призведе до помилки та припинення обробки запиту. Дійсні значення: All: всі етапи dry run будуть виконані
`gracePeriodSeconds`	integer	Часу у секундах перед видаленням обʼєкта. Значення повинно бути невідʼємним цілим числом. Значення нуль вказує на негайне видалення. Якщо це значення відсутнє, буде використано стандартний період очікування для зазначеного типу. Зазвичай використовується значення для конкретного обʼєкта, якщо не вказано. Нуль означає негайне видалення.
`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/networking.k8s.io/v1/namespaces/{namespace}/ingresses

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

Назва	Тип	Опис
`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	Часу у секундах перед видаленням обʼєкта. Значення повинно бути невідʼємним цілим числом. Значення нуль вказує на негайне видалення. Якщо це значення відсутнє, буде використано стандартний період очікування для зазначеного типу. Зазвичай використовується значення для конкретного обʼєкта, якщо не вказано. Нуль означає негайне видалення.
`ignoreStoreReadErrorWithClusterBreakingPotential`	boolean	Якщо встановлено в true, це призведе до небезпечного видалення ресурсу у випадку, якщо нормальний процес видалення не вдасться через помилку пошкодженого обʼєкта. Ресурс вважається пошкодженим, якщо його не можна успішно отримати з відповідного сховища томущо: a) його дані не можна трансформувати, наприклад, помилка дешифрування, або b) не вдається декодувати в обʼєкт. ПРИМІТКА: небезпечне видалення ігнорує обмеження завершувача, пропускає перевірки передумов і видаляє обʼєкт зі сховища. ПОПЕРЕДЖЕННЯ: це може потенційно порушити роботу кластера, якщо робоче навантаження, повʼязане з ресурсом, що видаляється небезпечно, покладається на нормальний процес видалення. Використовуйте лише якщо ви ДІЙСНО знаєте, що робите. Стандартне значення — false, і користувач повинен явно погодитися на його використання.
`labelSelector`	string	Селектор для обмеження списку обʼєктів, що повертаються, за їхніми мітками. Зазвичай повертаються всі обʼєкти.
`limit`	integer	limit є максимальним числом відповідей, які потрібно повернути для виклику списку. Якщо існує більше елементів, сервер встановить поле `continue` у метаданих списку на значення, яке можна використовувати з тим самим початковим запитом для отримання наступного набору результатів. Встановлення обмеження може повернути менше, ніж запитана кількість елементів (до нуля елементів) у випадку, якщо всі запитані обʼєкти відфільтровані, і клієнти повинні використовувати лише наявність поля continue, щоб визначити, чи доступні додаткові результати. Сервери можуть вирішити не підтримувати аргумент limit і повернуть усі доступні результати. Якщо limit вказано, а поле continue порожнє, клієнти можуть припустити, що результатів більше немає. Це поле не підтримується, якщо watch дорівнює true. Сервер гарантує, що обʼєкти, повернені при використанні 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` не встановлено, це інтерпретується як «послідовне читання», і подія 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	Час очікування для виклику list/watch. Це обмежує тривалість виклику, незалежно від будь-якої активності чи неактивності.

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

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

Відповідь

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

`get` Read

HTTP Запит

GET /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}

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

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

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

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

Відповідь

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

`get` List

HTTP Запит

GET /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses

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

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

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

Назва	Тип	Опис
`pretty`	string	Якщо 'true', то вихідні дані форматуються у зручному для читання вигляді. Зазвичай 'false', якщо user-agent не вказує оглядач або командний інструмент для роботи з HTTP (curl та wget).
`allowWatchBookmarks`	boolean	allowWatchBookmarks запитує події спостереження з типом "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, будуть ідентичні до виконання одного виклику списку без обмеження — тобто жодні обʼєкти, створені, змінені або видалені після першого запиту, не будуть включені в будь-які наступні продовжені запити. Це іноді називають послідовним знімком, і забезпечує, що клієнт, який використовує 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` не встановлено, це інтерпретується як «послідовне читання», і подія 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	Час очікування для виклику list/watch. Це обмежує тривалість виклику, незалежно від будь-якої активності чи неактивності.
`watch`	boolean	Спостерігати за змінами описаних ресурсів і повертати їх як потік сповіщень про додавання, оновлення та видалення. Вкажіть resourceVersion.

Відповідь

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

`get` List All Namespaces

HTTP Запит

GET /apis/networking.k8s.io/v1/ingresses

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

Назва	Тип	Опис
`allowWatchBookmarks`	boolean	allowWatchBookmarks запитує події спостереження з типом "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, будуть ідентичні до виконання одного виклику списку без обмеження — тобто жодні обʼєкти, створені, змінені або видалені після першого запиту, не будуть включені в будь-які наступні продовжені запити. Це іноді називають послідовним знімком, і забезпечує, що клієнт, який використовує 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` не встановлено, це інтерпретується як «послідовне читання», і подія 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	Час очікування для виклику list/watch. Це обмежує тривалість виклику, незалежно від будь-якої активності чи неактивності.
`watch`	boolean	Спостерігати за змінами описаних ресурсів і повертати їх як потік сповіщень про додавання, оновлення та видалення. Вкажіть resourceVersion.

Відповідь

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

`get` Watch

HTTP Запит

GET /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/ingresses/{name}

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

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

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

Назва	Тип	Опис
`allowWatchBookmarks`	boolean	allowWatchBookmarks запитує події спостереження з типом "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, будуть ідентичні до виконання одного виклику списку без обмеження — тобто жодні обʼєкти, створені, змінені або видалені після першого запиту, не будуть включені в будь-які наступні продовжені запити. Це іноді називають послідовним знімком, і забезпечує, що клієнт, який використовує 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` не встановлено, це інтерпретується як «послідовне читання», і подія 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	Час очікування для виклику list/watch. Це обмежує тривалість виклику, незалежно від будь-якої активності чи неактивності.
`watch`	boolean	Спостерігати за змінами описаних ресурсів і повертати їх як потік сповіщень про додавання, оновлення та видалення. Вкажіть resourceVersion.

Відповідь

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

`get` Watch List

HTTP Запит

GET /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/ingresses

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

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

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

Назва	Тип	Опис
`allowWatchBookmarks`	boolean	allowWatchBookmarks запитує події спостереження з типом "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, будуть ідентичні до виконання одного виклику списку без обмеження — тобто жодні обʼєкти, створені, змінені або видалені після першого запиту, не будуть включені в будь-які наступні продовжені запити. Це іноді називають послідовним знімком, і забезпечує, що клієнт, який використовує 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` не встановлено, це інтерпретується як «послідовне читання», і подія 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	Час очікування для виклику list/watch. Це обмежує тривалість виклику, незалежно від будь-якої активності чи неактивності.
`watch`	boolean	Спостерігати за змінами описаних ресурсів і повертати їх як потік сповіщень про додавання, оновлення та видалення. Вкажіть resourceVersion.

Відповідь

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

`get` Watch List All Namespaces

HTTP Запит

GET /apis/networking.k8s.io/v1/watch/ingresses

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

Назва	Тип	Опис
`allowWatchBookmarks`	boolean	allowWatchBookmarks запитує події спостереження з типом "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, будуть ідентичні до виконання одного виклику списку без обмеження — тобто жодні обʼєкти, створені, змінені або видалені після першого запиту, не будуть включені в будь-які наступні продовжені запити. Це іноді називають послідовним знімком, і забезпечує, що клієнт, який використовує 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` не встановлено, це інтерпретується як «послідовне читання», і подія 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	Час очікування для виклику list/watch. Це обмежує тривалість виклику, незалежно від будь-якої активності чи неактивності.
`watch`	boolean	Спостерігати за змінами описаних ресурсів і повертати їх як потік сповіщень про додавання, оновлення та видалення. Вкажіть resourceVersion.

Відповідь

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

`patch` Patch Status

HTTP Запит

PATCH /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}/status

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

Назва	Тип	Опис
`name`	string	Назва Ingress
`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), але необовʼязкове для типів патчів, що не застосовуються (JsonPatch, MergePatch, StrategicMergePatch).
`fieldValidation`	string	fieldValidation інструктує сервер, як обробляти обʼєкти в запиті (POST/PUT/PATCH), що містять невідомі або дубльовані поля. Дійсні значення: Ignore: Ігнорує всі невідомі поля, які без попередження видаляються з обʼєкта, а також ігнорує всі дублікати полів, крім останнього, на які натрапляє декодер. Це стандартна поведінка до v1.23. Warn: Надсилає попередження через стандартний заголовок відповіді для кожного невідомого поля, яке видаляється з обʼєкта, і для кожного дубльованого поля, яке зустрічається. Запит все ще буде успішним, якщо немає інших помилок, і буде зберігатися лише останнє з будь-яких дубльованих полів. Це стандартна поведінка у v1.23+ Strict: У цьому випадку запит завершиться з помилкою BadRequest, якщо з обʼєкта будуть вилучені невідомі поля або якщо будуть виявлені дублікати полів. Помилка, що повертається сервером, міститиме всі виявлені невідомі та дубльовані поля.
`force`	boolean	Force має на меті "примусово" застосовувати запити Apply. Це означає, що користувач повторно отримає конфліктні поля, що належать іншим користувачам. Прапорець Force повинен бути скасований для запитів, що не є патчами apply.

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

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

Відповідь

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

`get` Read Status

HTTP Запит

GET /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}/status

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

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

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

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

Відповідь

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

`put` Replace Status

HTTP Запит

PUT /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}/status

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

Назва	Тип	Опис
`name`	string	Назва Ingress
`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`	Ingress

Відповідь

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

Востаннє змінено June 10, 2026 at 8:00 PM PST: [uk] Ukrainian translation (all-in-one) (4e8fe0f729)

Ingress

Ingress

IngressSpec

IngressStatus

IngressList

HTTPIngressPath

HTTPIngressRuleValue

IngressBackend

IngressLoadBalancerIngress

IngressLoadBalancerStatus

IngressPortStatus

IngressRule

IngressServiceBackend

IngressTLS

ServiceBackendPort

Операції

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 Запит

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

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

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

Відповідь

`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