Розширені ресурси

401: Unauthorized

`get` отримати статус вказаного CustomResourceDefinition

HTTP запит

GET /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}/status

Параметри

name (в шляху): string, обовʼязково
імʼя CustomResourceDefinition
pretty (в запиті): string
pretty

Відповідь

401: Unauthorized

`list` перелік або перегляд обʼєктів типу CustomResourceDefinition

HTTP запит

GET /apis/apiextensions.k8s.io/v1/customresourcedefinitions

Параметри

allowWatchBookmarks (в запиті): boolean
allowWatchBookmarks
continue (в запиті): string
continue
fieldSelector (в запиті): string
fieldSelector
labelSelector (в запиті): string
labelSelector
limit (в запиті): integer
limit
pretty (в запиті): string
pretty
resourceVersion (в запиті): string
resourceVersion
resourceVersionMatch (в запиті): string
resourceVersionMatch
sendInitialEvents (в запиті): boolean
sendInitialEvents
timeoutSeconds (в запиті): integer
timeoutSeconds
watch (в запиті): boolean
watch

Відповідь

200 (CustomResourceDefinitionList): OK

401: Unauthorized

`create` створення CustomResourceDefinition

HTTP запит

POST /apis/apiextensions.k8s.io/v1/customresourcedefinitions

Параметри

body: CustomResourceDefinition, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
pretty (в запиті): string
pretty

Відповідь

201 (CustomResourceDefinition): Created

202 (CustomResourceDefinition): Accepted

401: Unauthorized

`update` заміна вказаного CustomResourceDefinition

HTTP запит

PUT /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}

Параметри

name (в шляху): string, обовʼязково
імʼя CustomResourceDefinition
body: CustomResourceDefinition, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
pretty (в запиті): string
pretty

Відповідь

201 (CustomResourceDefinition): Created

401: Unauthorized

`update` заміна статусу вказаного CustomResourceDefinition

HTTP запит

PUT /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}/status

Параметри

name (в шляху): string, обовʼязково
імʼя CustomResourceDefinition
body: CustomResourceDefinition, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
pretty (в запиті): string
pretty

Відповідь

201 (CustomResourceDefinition): Created

401: Unauthorized

`patch` часткове оновлення вказаного CustomResourceDefinition

HTTP запит

PATCH /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}

Параметри

name (в шляху): string, обовʼязково
імʼя CustomResourceDefinition
body: Patch, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
force (в запиті): boolean
force
pretty (в запиті): string
pretty

Відповідь

201 (CustomResourceDefinition): Created

401: Unauthorized

`patch` часткове оновлення статусу вказаного CustomResourceDefinition

HTTP запит

PATCH /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}/status

Параметри

name (в шляху): string, обовʼязково
імʼя CustomResourceDefinition
body: Patch, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
force (в запиті): boolean
force
pretty (в запиті): string
pretty

Відповідь

201 (CustomResourceDefinition): Created

401: Unauthorized

`delete` видалення CustomResourceDefinition

HTTP запит

DELETE /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}

Параметри

name (в шляху): string, обовʼязково
імʼя CustomResourceDefinition
body: DeleteOptions
dryRun (в запиті): string
dryRun
gracePeriodSeconds (в запиті): integer
gracePeriodSeconds
pretty (в запиті): string
pretty
propagationPolicy (в запиті): string
propagationPolicy

Відповідь

200 (Status): OK

202 (Status): Accepted

401: Unauthorized

`deletecollection` видалення колекції CustomResourceDefinition

HTTP запит

DELETE /apis/apiextensions.k8s.io/v1/customresourcedefinitions

Параметри

body: DeleteOptions
continue (в запиті): string
continue
dryRun (в запиті): string
dryRun
fieldSelector (в запиті): string
fieldSelector
gracePeriodSeconds (в запиті): integer
gracePeriodSeconds
labelSelector (в запиті): string
labelSelector
limit (в запиті): integer
limit
pretty (в запиті): string
pretty
propagationPolicy (в запиті): string
propagationPolicy
resourceVersion (в запиті): string
resourceVersion
resourceVersionMatch (в запиті): string
resourceVersionMatch
sendInitialEvents (в запиті): boolean
sendInitialEvents
timeoutSeconds (в запиті): integer
timeoutSeconds

Відповідь

200 (Status): OK

401: Unauthorized

2 - DeviceClass v1alpha3

DeviceClass — це ресурс, наданий постачальником або адміністратором, який містить конфігурацію пристрою та селектори.

apiVersion: resource.k8s.io/v1alpha3

import "k8s.io/api/resource/v1alpha3"

DeviceClass

DeviceClass — це ресурс, наданий постачальником або адміністратором, який містить конфігурацію пристрою та селектори. На нього можна посилатися у запитах до пристрою, щоб застосувати ці пресети. Охоплює кластер.

Це альфа-тип і вимагає увімкнення функціональної можливості DynamicResourceAllocation.

apiVersion: resource.k8s.io/v1alpha3
kind: DeviceClass
metadata (ObjectMeta)
Стандартний обʼєкт метаданих
spec (DeviceClassSpec), обовʼязково
Spec визначає, що можна призначити і як це налаштувати.
Поле є змінюваним. Споживачі повинні бути готові до того, що класи можуть змінюватися в будь-який час, як через оновлення, так і через заміну. Розподілення заявок виконується один раз на основі того, що було встановлено в класах на момент виділення.
Зміна spec автоматично збільшує номер metadata.generation.

DeviceClassSpec

DeviceClassSpec використовується в [DeviceClass] для визначення того, що може бути призначено і як це налаштувати.

config ([]DeviceClassConfiguration)
Atomic: буде замінено під час злиття
Config визначає параметри конфігурації, які застосовуються до кожного пристрою, що описується у цьому класі. Деякі класи потенційно можуть задовольнятися кількома драйверами, тому кожен екземпляр конфігурації постачальника застосовується лише до одного драйвера.
Вони передаються драйверу, але не враховуються при розподілі заявки.
DeviceClassConfiguration використовується в DeviceClass.
- config.opaque (OpaqueDeviceConfiguration)
  Opaque надає специфічні для драйвера параметри конфігурації.
  OpaqueDeviceConfiguration містить параметри конфігурації драйвера у форматі, визначеному постачальником драйвера.
  - config.opaque.driver (string), обовʼязково
    Driver використовується для визначення, в який втулок kubelet потрібно передати ці параметри конфігурації.
    Політика допуску, надана розробником драйвера, може використовувати це для прийняття рішення про те, чи потрібно перевіряти їх.
    Повинен бути DNS піддоменом і закінчуватися на DNS домен, що належить постачальнику драйвера.
  - config.opaque.parameters (RawExtension), обовʼязково
    Параметри можуть містити довільні дані. Відповідальність за перевірку та керування версіями покладається на розробника драйверів. Зазвичай це включає самоідентифікацію та версію ("kind" + "apiVersion" для типів Kubernetes), а також конвертацію між різними версіями.
    RawExtension використовується для зберігання розширень у зовнішніх версіях.
    Щоб використовувати це, створіть поле, яке має тип RawExtension у вашій зовнішній, версійованій структурі, і Object у вашій внутрішній структурі. Також потрібно зареєструвати ваші різні типи втулків.
    // Внутрішній пакунок:
```
type MyAPIObject struct {
	runtime.TypeMeta `json:",inline"`
	MyPlugin runtime.Object `json:"myPlugin"`
}

type PluginA struct {
	AOption string `json:"aOption"`
}
```
    // Зовнішній пакунок:
```
type MyAPIObject struct {
	runtime.TypeMeta `json:",inline"`
	MyPlugin runtime.RawExtension `json:"myPlugin"`
}

type PluginA struct {
	AOption string `json:"aOption"`
}
```
    // Готовий JSON буде виглядати приблизно так:
```
{
	"kind":"MyAPIObject",
	"apiVersion":"v1",
	"myPlugin": {
		"kind":"PluginA",
		"aOption":"foo",
	},
}
```
    Що відбувається? Спочатку декодування використовує json або yaml для десеріалізації даних у ваш зовнішній MyAPIObject. Це призводить до зберігання необробленого JSON, але без розпакування. Наступний крок — копіювання (за допомогою pkg/conversion) у внутрішню структуру. Функції перетворення, встановлені в DefaultScheme пакета runtime, розпаковують JSON, збережений у RawExtension, перетворюючи його в правильний тип обʼєкта і зберігаючи його в Object. (TODO: У випадку, коли обʼєкт має невідомий тип, буде створено і збережено обʼєкт runtime.Unknown.)
selectors ([]DeviceSelector)
Atomic: буде замінено під час злиття
Кожному селектору повинен відповідати пристрій, що заявляється в цьому класі.
DeviceSelector повинен мати рівно одне встановлене поле.
- selectors.cel (CELDeviceSelector)
  CEL містить вираз CEL для вибору пристрою.
  CELDeviceSelector містить вираз CEL для вибору пристрою.
  - selectors.cel.expression (string), обовʼязковий
    Вираз є виразом CEL, який оцінює один пристрій. Він має оцінюватися як true, коли пристрій відповідає бажаним критеріям, і як false, коли не відповідає. Будь-який інший результат є помилкою і призводить до зупинки надання пристроїв.
    Вхідні дані виразу — це обʼєкт з назвою "device", який має наступні властивості:
    - driver (рядок): імʼя драйвера, який визначає цей пристрій.
    - attributes (map[string]object): атрибути пристрою, згруповані за префіксом (наприклад, device.attributes["dra.example.com"] оцінюється як обʼєкт з усіма атрибутами, які були префіксовані "dra.example.com").
    - capacity (map[string]object): обсяги пристрою, згруповані за префіксом.
    Приклад: Розглянемо пристрій з driver="dra.example.com", який надає два атрибути з назвою "model" та "ext.example.com/family" і один обсяг з назвою "modules". Вхідні дані для цього виразу будуть мати такі поля:
```
device.driver
device.attributes["dra.example.com"].model
device.attributes["ext.example.com"].family
device.capacity["dra.example.com"].modules
```
    Поле device.driver можна використовувати для перевірки конкретного драйвера, або як загальну попередню умову (тобто ви хочете розглядати лише пристрої від цього драйвера), або як частину виразу з кількома умовами, який призначений для розгляду пристроїв з різних драйверів.
    Тип значення кожного атрибута визначається визначенням пристрою, і користувачі, які пишуть ці вирази, повинні звертатися до документації для своїх конкретних драйверів. Тип значення кожного обсягу — Quantity.
    Якщо невідомий префікс використовується для запиту в device.attributes або device.capacity, буде повернено порожній map. Будь-яке посилання на невідоме поле спричинить помилку оцінки і зупинку виділення.
    Робочий вираз має перевіряти наявність атрибутів перед їх використанням.
    Для зручності використання доступна функція cel.bind(), яка може бути використана для спрощення виразів, що звертаються до кількох атрибутів з одного домену. Наприклад:
```
cel.bind(dra, device.attributes["dra.example.com"], dra.someBool && dra.anotherBool)
```
suitableNodes (NodeSelector)
Лише вузли, що відповідають селектору, будуть враховуватися планувальником при спробі знайти Вузол, що підходить для Podʼа, коли цей Pod використовує запит, який ще не був виділений і цей запит виділяється через контролер панелі управління. Він ігнорується, коли запит не використовує контролер панелі управління для виділення.
Налаштування цього поля є необовʼязковим. Якщо не задано, всі Вузли є кандидатами.
Це поле є альфа-версією і потребує увімкнення функціональної можливості DRAControlPlaneController.
Селектор вузлів представляє об'єднання результатів одного або кількох запитів міток над набором вузлів; тобто, він представляє OR (логічне "або") селекторів, що представлені термінами селектора вузлів.
- suitableNodes.nodeSelectorTerms ([]NodeSelectorTerm), обов'язково
  Atomic: буде замінено під час злиття
  Обов'язковий параметр. Список термів селектора вузлів. Терми обʼєднуються оператором OR.
  Null або порожній термін селектора вузла не відповідає жодному об'єкту. Вимоги до них складаються за принципом AND. Тип TopologySelectorTerm реалізує підмножину NodeSelectorTerm.
  - suitableNodes.nodeSelectorTerms.matchExpressions ([]NodeSelectorRequirement)
    Atomic: буде замінено під час злиття
    Список вимог до селектора вузлів за мітками вузлів.
  - suitableNodes.nodeSelectorTerms.matchFields ([]NodeSelectorRequirement)
    Atomic: буде замінено під час злиття
    Список вимог до селектора вузла за полями вузла.

DeviceClassList

DeviceClassList — це колекція класів.

apiVersion: resource.k8s.io/v1alpha3
kind: DeviceClassList
metadata (ListMeta)
Стандартні метадані списку
items ([]DeviceClass), обовʼязково
Items — список класів ресурсів.

Operations

`get` отримати вказаний DeviceClass

HTTP запит

GET /apis/resource.k8s.io/v1alpha3/deviceclasses/{name}

Параметри

name (в шляху): string, обовʼязково
імʼя DeviceClass
pretty (в запиті): string
pretty

Відповідь

200 (DeviceClass): OK

401: Unauthorized

`list` перелік або перегляд обʼєктів типу DeviceClass

HTTP запит

GET /apis/resource.k8s.io/v1alpha3/deviceclasses

Параметри

allowWatchBookmarks (в запиті): boolean
allowWatchBookmarks
continue (в запиті): string
continue
fieldSelector (в запиті): string
fieldSelector
labelSelector (в запиті): string
labelSelector
limit (в запиті): integer
limit
pretty (в запиті): string
pretty
resourceVersion (в запиті): string
resourceVersion
resourceVersionMatch (в запиті): string
resourceVersionMatch
sendInitialEvents (в запиті): boolean
sendInitialEvents
timeoutSeconds (в запиті): integer
timeoutSeconds
watch (в запиті): boolean
watch

Відповідь

200 (DeviceClassList): OK

401: Unauthorized

`create` створення DeviceClass

HTTP запит

POST /apis/resource.k8s.io/v1alpha3/deviceclasses

Параметри

body: DeviceClass, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
pretty (в запиті): string
pretty

Відповідь

200 (DeviceClass): OK

201 (DeviceClass): Created

202 (DeviceClass): Accepted

401: Unauthorized

`update` заміна вказаного DeviceClass

HTTP запит

PUT /apis/resource.k8s.io/v1alpha3/deviceclasses/{name}

Параметри

name (в шляху): string, обовʼязково
імʼя DeviceClass
body: DeviceClass, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
pretty (в запиті): string
pretty

Відповідь

200 (DeviceClass): OK

201 (DeviceClass): Created

401: Unauthorized

`patch` часткове оновлення вказаного DeviceClass

HTTP запит

PATCH /apis/resource.k8s.io/v1alpha3/deviceclasses/{name}

Параметри

name (в шляху): string, обовʼязково
імʼя DeviceClass
body: Patch, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
force (в запиті): boolean
force
pretty (в запиті): string
pretty

Відповідь

200 (DeviceClass): OK

201 (DeviceClass): Created

401: Unauthorized

`delete` видалення DeviceClass

HTTP запит

DELETE /apis/resource.k8s.io/v1alpha3/deviceclasses/{name}

Параметри

name (в шляху): string, обовʼязково
імʼя DeviceClass
body: DeleteOptions
dryRun (в запиті): string
dryRun
gracePeriodSeconds (в запиті): integer
gracePeriodSeconds
pretty (в запиті): string
pretty
propagationPolicy (в запиті): string
propagationPolicy

Відповідь

200 (DeviceClass): OK

202 (DeviceClass): Accepted

401: Unauthorized

`deletecollection` видалення колекції DeviceClass

HTTP запит

DELETE /apis/resource.k8s.io/v1alpha3/deviceclasses

Параметри

body: DeleteOptions
continue (в запиті): string
continue
dryRun (в запиті): string
dryRun
fieldSelector (в запиті): string
fieldSelector
gracePeriodSeconds (в запиті): integer
gracePeriodSeconds
labelSelector (в запиті): string
labelSelector
limit (в запиті): integer
limit
pretty (в запиті): string
pretty
propagationPolicy (в запиті): string
propagationPolicy
resourceVersion (в запиті): string
resourceVersion
resourceVersionMatch (в запиті): string
resourceVersionMatch
sendInitialEvents (в запиті): boolean
sendInitialEvents
timeoutSeconds (в запиті): integer
timeoutSeconds

Відповідь

200 (Status): OK

401: Unauthorized

3 - DeviceClass v1beta1

apiVersion: resource.k8s.io/v1beta1

import "k8s.io/api/resource/v1beta1"

DeviceClass

Це альфа-тип і вимагає увімкнення функціональної можливості DynamicResourceAllocation.

apiVersion: resource.k8s.io/v1beta1
kind: DeviceClass
metadata (ObjectMeta)
Стандартний обʼєкт метаданих
spec (DeviceClassSpec), обовʼязково
Spec визначає, що можна призначити і як це налаштувати.
Поле є змінюваним. Споживачі повинні бути готові до того, що класи можуть змінюватися в будь-який час, як через оновлення, так і через заміну. Розподілення заявок виконується один раз на основі того, що було встановлено в класах на момент виділення.
Зміна spec автоматично збільшує номер metadata.generation.

DeviceClassSpec

DeviceClassSpec використовується в [DeviceClass] для визначення того, що може бути призначено і як це налаштувати.

config ([]DeviceClassConfiguration)
Atomic: буде замінено під час злиття
Config визначає параметри конфігурації, які застосовуються до кожного пристрою, що описується у цьому класі. Деякі класи потенційно можуть задовольнятися кількома драйверами, тому кожен екземпляр конфігурації постачальника застосовується лише до одного драйвера.
Вони передаються драйверу, але не враховуються при розподілі заявки.
DeviceClassConfiguration використовується в DeviceClass.
- config.opaque (OpaqueDeviceConfiguration)
  Opaque надає специфічні для драйвера параметри конфігурації.
  OpaqueDeviceConfiguration містить параметри конфігурації драйвера у форматі, визначеному постачальником драйвера.
  - config.opaque.driver (string), обовʼязково
    Driver використовується для визначення, в який втулок kubelet потрібно передати ці параметри конфігурації.
    Політика допуску, надана розробником драйвера, може використовувати це для прийняття рішення про те, чи потрібно перевіряти їх.
    Повинен бути DNS піддоменом і закінчуватися на DNS домен, що належить постачальнику драйвера.
  - config.opaque.parameters (RawExtension), обовʼязково
    Параметри можуть містити довільні дані. Відповідальність за перевірку та керування версіями покладається на розробника драйверів. Зазвичай це включає самоідентифікацію та версію ("kind" + "apiVersion" для типів Kubernetes), а також конвертацію між різними версіями.
    RawExtension використовується для зберігання розширень у зовнішніх версіях.
    Щоб використовувати це, створіть поле, яке має тип RawExtension у вашій зовнішній, версійованій структурі, і Object у вашій внутрішній структурі. Також потрібно зареєструвати ваші різні типи втулків.
    // Внутрішній пакунок:
```
type MyAPIObject struct {
	runtime.TypeMeta `json:",inline"`
	MyPlugin runtime.Object `json:"myPlugin"`
}

type PluginA struct {
	AOption string `json:"aOption"`
}
```
    // Зовнішній пакунок:
```
type MyAPIObject struct {
	runtime.TypeMeta `json:",inline"`
	MyPlugin runtime.RawExtension `json:"myPlugin"`
}

type PluginA struct {
	AOption string `json:"aOption"`
}
```
    // Готовий JSON буде виглядати приблизно так:
```
{
	"kind":"MyAPIObject",
	"apiVersion":"v1",
	"myPlugin": {
		"kind":"PluginA",
		"aOption":"foo",
	},
}
```
    Що відбувається? Спочатку декодування використовує json або yaml для десеріалізації даних у ваш зовнішній MyAPIObject. Це призводить до зберігання необробленого JSON, але без розпакування. Наступний крок — копіювання (за допомогою pkg/conversion) у внутрішню структуру. Функції перетворення, встановлені в DefaultScheme пакета runtime, розпаковують JSON, збережений у RawExtension, перетворюючи його в правильний тип обʼєкта і зберігаючи його в Object. (TODO: У випадку, коли обʼєкт має невідомий тип, буде створено і збережено обʼєкт runtime.Unknown.)
selectors ([]DeviceSelector)
Atomic: буде замінено під час злиття
Кожному селектору повинен відповідати пристрій, що заявляється в цьому класі.
DeviceSelector повинен мати рівно одне встановлене поле.
- selectors.cel (CELDeviceSelector)
  CEL містить вираз CEL для вибору пристрою.
  CELDeviceSelector містить вираз CEL для вибору пристрою.
  - selectors.cel.expression (string), обовʼязково
    Вираз є виразом CEL, який оцінює один пристрій. Він має оцінюватися як true, коли пристрій відповідає бажаним критеріям, і як false, коли не відповідає. Будь-який інший результат є помилкою і призводить до зупинки надання пристроїв.
    Вхідні дані виразу — це обʼєкт з назвою "device", який має наступні властивості:
    - driver (рядок): імʼя драйвера, який визначає цей пристрій.
    - attributes (map[string]object): атрибути пристрою, згруповані за префіксом (наприклад, device.attributes["dra.example.com"] оцінюється як обʼєкт з усіма атрибутами, які були префіксовані "dra.example.com").
    - capacity (map[string]object): обсяги пристрою, згруповані за префіксом.
    Приклад: Розглянемо пристрій з driver="dra.example.com", який надає два атрибути з назвою "model" та "ext.example.com/family" і один обсяг з назвою "modules". Вхідні дані для цього виразу будуть мати такі поля:
```
device.driver
device.attributes["dra.example.com"].model
device.attributes["ext.example.com"].family
device.capacity["dra.example.com"].modules
```
    Поле device.driver можна використовувати для перевірки конкретного драйвера, або як загальну попередню умову (тобто ви хочете розглядати лише пристрої від цього драйвера), або як частину виразу з кількома умовами, який призначений для розгляду пристроїв з різних драйверів.
    Тип значення кожного атрибута визначається визначенням пристрою, і користувачі, які пишуть ці вирази, повинні звертатися до документації для своїх конкретних драйверів. Тип значення кожного обсягу — Quantity.
    Якщо невідомий префікс використовується для запиту в device.attributes або device.capacity, буде повернено порожній map. Будь-яке посилання на невідоме поле спричинить помилку оцінки і зупинку виділення.
    Робочий вираз має перевіряти наявність атрибутів перед їх використанням.
    Для зручності використання доступна функція cel.bind(), яка може бути використана для спрощення виразів, що звертаються до кількох атрибутів з одного домену. Наприклад:
```
cel.bind(dra, device.attributes["dra.example.com"], dra.someBool && dra.anotherBool)
```
suitableNodes (NodeSelector)
Лише вузли, що відповідають селектору, будуть враховуватися планувальником при спробі знайти Вузол, що підходить для Podʼа, коли цей Pod використовує запит, який ще не був виділений і цей запит виділяється через контролер панелі управління. Він ігнорується, коли запит не використовує контролер панелі управління для виділення.
Налаштування цього поля є необовʼязковим. Якщо не задано, всі Вузли є кандидатами.
Це поле є альфа-версією і потребує увімкнення функціональної можливості DRAControlPlaneController.
Селектор вузлів представляє об'єднання результатів одного або кількох запитів міток над набором вузлів; тобто, він представляє OR (логічне "або") селекторів, що представлені термінами селектора вузлів.
- suitableNodes.nodeSelectorTerms ([]NodeSelectorTerm), обовʼязково
  Atomic: буде замінено під час злиття
  Обов'язковий параметр. Список термів селектора вузлів. Терми обʼєднуються оператором OR.
  Null або порожній термін селектора вузла не відповідає жодному об'єкту. Вимоги до них складаються за принципом AND. Тип TopologySelectorTerm реалізує підмножину NodeSelectorTerm.
  - suitableNodes.nodeSelectorTerms.matchExpressions ([]NodeSelectorRequirement)
    Atomic: буде замінено під час злиття
    Список вимог до селектора вузлів за мітками вузлів.
  - suitableNodes.nodeSelectorTerms.matchFields ([]NodeSelectorRequirement)
    Atomic: буде замінено під час злиття
    Список вимог до селектора вузла за полями вузла.

DeviceClassList

DeviceClassList — це колекція класів.

apiVersion: resource.k8s.io/v1beta1
kind: DeviceClassList
metadata (ListMeta)
Стандартні метадані списку
items ([]DeviceClass), обовʼязково
Items — список класів ресурсів.

Operations

`get` отримати вказаний DeviceClass

HTTP запит

GET /apis/resource.k8s.io/v1beta1/deviceclasses/{name}

Параметри

name (в шляху): string, обовʼязково
name of the DeviceClass
pretty (в запиті): string
pretty

Відповідь

200 (DeviceClass): OK

401: Unauthorized

`list` перелік або перегляд обʼєктів типу DeviceClass

HTTP запит

GET /apis/resource.k8s.io/v1beta1/deviceclasses

Параметри

allowWatchBookmarks (в запиті): boolean
allowWatchBookmarks
continue (в запиті): string
continue
fieldSelector (в запиті): string
fieldSelector
labelSelector (в запиті): string
labelSelector
limit (в запиті): integer
limit
pretty (в запиті): string
pretty
resourceVersion (в запиті): string
resourceVersion
resourceVersionMatch (в запиті): string
resourceVersionMatch
sendInitialEvents (в запиті): boolean
sendInitialEvents
timeoutSeconds (в запиті): integer
timeoutSeconds
watch (в запиті): boolean
watch

Відповідь

200 (DeviceClassList): OK

401: Unauthorized

`create` створення DeviceClass

HTTP запит

POST /apis/resource.k8s.io/v1beta1/deviceclasses

Параметри

body: DeviceClass, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
pretty (в запиті): string
pretty

Відповідь

200 (DeviceClass): OK

201 (DeviceClass): Created

202 (DeviceClass): Accepted

401: Unauthorized

`update` заміна вказаного DeviceClass

HTTP запит

PUT /apis/resource.k8s.io/v1beta1/deviceclasses/{name}

Параметри

name (в шляху): string, обовʼязково
name of the DeviceClass
body: DeviceClass, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
pretty (в запиті): string
pretty

Відповідь

200 (DeviceClass): OK

201 (DeviceClass): Created

401: Unauthorized

`patch` часткове оновлення вказаного DeviceClass

HTTP запит

PATCH /apis/resource.k8s.io/v1beta1/deviceclasses/{name}

Параметри

name (в шляху): string, обовʼязково
name of the DeviceClass
body: Patch, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
force (в запиті): boolean
force
pretty (в запиті): string
pretty

Відповідь

200 (DeviceClass): OK

201 (DeviceClass): Created

401: Unauthorized

`delete` видалення DeviceClass

HTTP запит

DELETE /apis/resource.k8s.io/v1beta1/deviceclasses/{name}

Параметри

name (в шляху): string, обовʼязково
name of the DeviceClass
body: DeleteOptions
dryRun (в запиті): string
dryRun
gracePeriodSeconds (в запиті): integer
gracePeriodSeconds
pretty (в запиті): string
pretty
propagationPolicy (в запиті): string
propagationPolicy

Відповідь

200 (DeviceClass): OK

202 (DeviceClass): Accepted

401: Unauthorized

`deletecollection` видалення колекції DeviceClass

HTTP запит

DELETE /apis/resource.k8s.io/v1beta1/deviceclasses

Параметри

body: DeleteOptions
continue (в запиті): string
continue
dryRun (в запиті): string
dryRun
fieldSelector (в запиті): string
fieldSelector
gracePeriodSeconds (в запиті): integer
gracePeriodSeconds
labelSelector (в запиті): string
labelSelector
limit (в запиті): integer
limit
pretty (в запиті): string
pretty
propagationPolicy (в запиті): string
propagationPolicy
resourceVersion (в запиті): string
resourceVersion
resourceVersionMatch (в запиті): string
resourceVersionMatch
sendInitialEvents (в запиті): boolean
sendInitialEvents
timeoutSeconds (в запиті): integer
timeoutSeconds

Відповідь

200 (Status): OK

401: Unauthorized

4 - MutatingWebhookConfiguration

MutatingWebhookConfiguration описує конфігурацію вебхука, який приймає або відхиляє і може змінювати обʼєкт.

apiVersion: admissionregistration.k8s.io/v1

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

MutatingWebhookConfiguration

MutatingWebhookConfiguration описує конфігурацію вебхука, який приймає або відхиляє і може змінювати обʼєкт.

apiVersion: admissionregistration.k8s.io/v1
kind: MutatingWebhookConfiguration
metadata (ObjectMeta)
Стандартний обʼєкт метаданих; Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata.
webhooks ([]MutatingWebhook)
Patch strategy: злиття за ключем name
Map: унікальні значення ключа name будуть збережені під час злиття
Webhooks — це список вебхуків та відповідних ресурсів і операцій.
MutatingWebhook описує вебхук допуску та ресурси й операції, до яких він застосовується.
- webhooks.admissionReviewVersions ([]string), обовʼязково
  Atomic: буде замінено під час злиття
  AdmissionReviewVersions — це впорядкований список версій AdmissionReview, які очікує вебхук. Сервер API спробує використати першу версію зі списку, яку він підтримує. Якщо жодна з вказаних версій не підтримується сервером API, перевірка цього обʼєкта зазнає невдачі. Якщо збережена конфігурація вебхука вказує дозволені версії, але не включає жодної версії, відомої серверу API, виклики до вебхука зазнають невдачі й підпадають під політику відмови.
- webhooks.clientConfig (WebhookClientConfig), обовʼязково
  ClientConfig визначає, як спілкуватися з вебхуком. Обовʼязково.
  WebhookClientConfig містить інформацію для встановлення TLS-зʼєднання з вебхуком.
  - webhooks.clientConfig.caBundle ([]byte)
    caBundle — це закодований у PEM набір сертифікатів CA, який використовуватиметься для перевірки сертифіката сервера вебхука. Якщо не вказано, використовуються системні корені довіри на сервері API.
  - webhooks.clientConfig.service (ServiceReference)
    service — це посилання на сервіс для цього вебхука. Необхідно вказати або service, або url.
    Якщо вебхук працює в межах кластера, то слід використовувати service.
    ServiceReference містить посилання на Service.legacy.k8s.io.
    - webhooks.clientConfig.service.name (string), обовʼязково
      name — це імʼя сервісу. Обовʼязково.
    - webhooks.clientConfig.service.namespace (string), обовʼязково
      namespace — це простір імен сервісу. Обовʼязково.
    - webhooks.clientConfig.service.path (string)
      path — це необовʼязковий URL шлях, який буде надіслано в будь-якому запиті до цього сервісу.
    - webhooks.clientConfig.service.port (int32)
      Якщо вказано, то це порт на сервісі, який є хостом вебхуку. Типово 443 для зворотної сумісності. port має бути дійсним номером порту (1-65535, включно).
  - webhooks.clientConfig.url (string)
    url вказує місце розташування вебхука в стандартній формі URL (scheme://host:port/path). Необхідно вказати або url, або service.
    host не повинен посилатися на сервіс, що працює в кластері; використовуйте поле service натомість. Хост може бути знайдений через зовнішній DNS в деяких серверах API (наприклад, kube-apiserver не може працювати з кластерним DNS, оскільки це було б порушенням розшарування). host може також бути IP-адресою.
    Зверніть увагу, що використання localhost або 127.0.0.1 як host є ризикованим, якщо ви не вживаєте великих заходів обережності, щоб запустити цей вебхук на всіх хостах, що запускають сервер API, який може потребувати викликів до цього вебхука. Такі встановлення, ймовірно, будуть непереносимими, тобто їх буде важко розгорнути в новому кластері.
    Схема має бути "https"; URL має починатися з "https://".
    Шлях є необовʼязковим, і, якщо він присутній, може бути будь-яким рядком, допустимим в URL. Ви можете використовувати шлях для передачі довільного рядка до вебхука, наприклад, ідентифікатора кластера.
    Спроба використання автентифікації користувача або базової автентифікації, наприклад, "user:password@", не дозволена. Також не дозволяються фрагменти ("#...") і параметри запиту ("?...").
- webhooks.name (string), обовʼязково
  Імʼя вебхуку допуску. Імʼя має бути повністю кваліфікованим, наприклад, imagepolicy.kubernetes.io, де "imagepolicy" є назвою вебхука, а kubernetes.io — назвою організації. Обовʼязково.
- webhooks.sideEffects (string), обовʼязково
  SideEffects вказує, чи має цей вебхук побічні ефекти. Допустимі значення: None, NoneOnDryRun (вебхуки, створені у v1beta1, також можуть вказати Some або Unknown). Вебхуки з побічними ефектами МАЮТЬ реалізувати систему узгодження, оскільки запит може бути відхилено на наступному етапі ланцюжка допуску, і побічні ефекти потрібно буде скасувати. Запити з атрибутом dryRun автоматично відхиляються, якщо вони відповідають вебхуку з sideEffects == Unknown або Some.
- webhooks.failurePolicy (string)
  FailurePolicy визначає, як обробляються нерозпізнані помилки від точки доступу допуску — дозволені значення: Ignore або Fail. Стандартне значення — Fail.
- webhooks.matchConditions ([]MatchCondition)
  Patch strategy: злиття за ключем name
  Map: унікальні значення за ключем name будуть збережені під час злиття
  MatchConditions — це список умов, які мають бути виконані для надсилання запиту до цього вебхука. Умови відповідності фільтрують запити, які вже були підібрані за правилами, namespaceSelector і objectSelector. Порожній список matchConditions відповідає всім запитам. Максимальна кількість умов відповідності — 64.
  Логіка точного збігу така (за порядком):
  1. Якщо БУДЬ-ЯКА умова відповідності оцінюється як FALSE, вебхук оминається.
  2. Якщо ВСІ умови відповідності оцінюються як TRUE, вебхук викликається.
  3. Якщо будь-яка умова відповідності оцінюється як помилка (але жодна не є FALSE):
    - Якщо failurePolicy=Fail, запит відхиляється
    - Якщо failurePolicy=Ignore, помилка ігнорується і вебхук оминається
  MatchCondition представляє умову, яка має бути виконана для надсилання запиту до вебхука.
  - webhooks.matchConditions.expression (string), обовʼязково
    Expression представляє вираз, який буде оцінено CEL. Результат обробки — bool. Вирази CEL мають доступ до вмісту AdmissionRequest і Authorizer, організованих у змінні CEL:
    'object' — Обʼєкт із вхідного запиту. Значення null для запитів DELETE. 'oldObject' — Наявний обʼєкт. Значення null для запитів CREATE. 'request' — Атрибути запиту допуску (/pkg/apis/admission/types.go#AdmissionRequest). 'authorizer' — CEL Authorizer. Може бути використано для виконання перевірок авторизації для виконавця (користувач або службового облікового запису) запиту. Див. https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz 'authorizer.requestResource' — CEL ResourceCheck, створений з 'authorizer' і налаштований із ресурсом запиту. Документація щодо CEL: https://kubernetes.io/docs/reference/using-api/cel/
    Обовʼязково.
  - webhooks.matchConditions.name (string), обовʼязково
    Name — це ідентифікатор цієї умови відповідності, використовується для стратегії злиття умов відповідності, а також для надання ідентифікатора для цілей логування. Хороша назва має бути описовою для повʼязаного виразу. Назва має бути кваліфікованою назвою, що складається з алфавітно-цифрових символів, '-', '' або '.', і має починатися та закінчуватися алфавітно-цифровим символом (наприклад, 'MyName' або 'my.name' або '123-abc', регулярний вираз, що використовується для перевірки, — '([A-Za-z0-9][-A-Za-z0-9.]*)?[A-Za-z0-9]') з необовʼязковим префіксом DNS субдомену та '/' (наприклад, 'example.com/MyName').
    Обовʼязково.
- webhooks.matchPolicy (string)
  matchPolicy визначає, як використовується список "rules" для відповідності вхідним запитам. Допустимі значення — "Exact" або "Equivalent".
  - Exact: відповідність запиту тільки в тому випадку, якщо він точно відповідає зазначеному правилу. Наприклад, якщо розгортання (deployments) можуть бути змінені через apps/v1, apps/v1beta1 і extensions/v1beta1, але "rules" включають тільки apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"], запит до apps/v1beta1 або extensions/v1beta1 не буде надіслано до вебхука.
  - Equivalent: відповідність запиту, якщо він змінює ресурс, вказаний у правилах, навіть через іншу групу API або версію. Наприклад, якщо розгортання (deployments) можуть бути змінені через apps/v1, apps/v1beta1 і extensions/v1beta1, і "rules" включають тільки apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"], запит до apps/v1beta1 або extensions/v1beta1 буде перетворений на apps/v1 і надісланий до вебхука.
  Стандартне значення — "Equivalent".
- webhooks.namespaceSelector (LabelSelector)
  NamespaceSelector визначає, чи буде вебхук працювати з обʼєктом на основі того, чи збігається простір імен для цього обʼєкта з селектором. Якщо обʼєкт сам є простором імен, перевірка збігу виконується за метаданими обʼєкта. Якщо обʼєкт є іншим ресурсом на рівні кластера, він ніколи не оминає вебхук.
  Наприклад, щоб запустити вебхук для будь-яких обʼєктів, чий простір імен не повʼязаний з "runlevel" 0 або 1, потрібно налаштувати селектор наступним чином:
```
"namespaceSelector": {
  "matchExpressions": [
    {
      "key": "runlevel",
      "operator": "NotIn",
      "values": [
        "0",
        "1"
      ]
    }
  ]
}
```
  Якщо замість цього ви хочете запустити вебхук для будь-яких обʼєктів, чий простір імен повʼязаний з "environment" "prod" або "staging", потрібно налаштувати селектор наступним чином:
```
"namespaceSelector": {
  "matchExpressions": [
    {
      "key": "environment",
      "operator": "In",
      "values": [
        "prod",
        "staging"
      ]
    }
  ]
}
```
  Див. https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/ для отримання додаткових прикладів селекторів міток.
  Типове значення — порожній LabelSelector, який має збіг зі всім.
- webhooks.objectSelector (LabelSelector)
  ObjectSelector визначає, чи буде вебхук працювати з обʼєктом на основі того, чи має обʼєкт відповідні мітки. ObjectSelector оцінюється як для oldObject, так і для newObject, які будуть надіслані до вебхука, і вважається відповідним, якщо будь-який з обʼєктів відповідає селектору. Нульовий обʼєкт (oldObject у випадку створення або newObject у випадку видалення) або обʼєкт, який не може мати міток (наприклад, DeploymentRollback або PodProxyOptions обʼєкт), не вважається таким, що має збіг. Використовуйте objectSelector лише якщо вебхук є опціональним, оскільки кінцеві користувачі можуть оминути вебхук допуску, встановивши мітки. Типове значення — порожній LabelSelector, який має збіг зі всім.
- webhooks.reinvocationPolicy (string)
  reinvocationPolicy вказує, чи має цей вебхук викликатися кілька разів у рамках однієї оцінки допуску. Допустимі значення — "Never" і "IfNeeded".
  Never: вебхук не буде викликатися більше одного разу в рамках однієї оцінки допуску.
  IfNeeded: вебхук буде викликаний щонайменше один додатковий раз у рамках оцінки допуску, якщо обʼєкт, який допускаєтсья, змінюється іншими втулками допуску після початкового виклику вебхука. Вебхуки, які вказують цю опцію, мають бути ідемпотентними, здатними обробляти обʼєкти, які вони попередньо прийняли. Зверніть увагу:
  - не гарантується, що кількість додаткових викликів буде дорівнювати одному.
  - якщо додаткові виклики призводять до подальших змін обʼєкта, вебхуки не гарантуються до повторного виклику.
  - вебхуки, що використовують цю опцію, можуть бути впорядковані для мінімізації кількості додаткових викликів.
  - для перевірки обʼєкта після завершення всіх змін, використовуйте вебхук для валідації допуску.
  Стандартне значення — "Never".
- webhooks.rules ([]RuleWithOperations)
  Atomic: буде замінено під час злиття
  Rules описує, які операції з якими ресурсами/субресурсами цікавлять вебхук. Вебхук цікавить операція, якщо вона відповідає будь-якому правилу. Однак, щоб запобігти тому, що ValidatingAdmissionWebhooks і MutatingAdmissionWebhooks можуть привести кластер до стану, з якого неможливо відновитися без повного вимкнення втулка, ValidatingAdmissionWebhooks і MutatingAdmissionWebhooks ніколи не викликаються на запити допуску для обʼєктів ValidatingWebhookConfiguration і MutatingWebhookConfiguration.
  RuleWithOperations — це кортеж операцій і ресурсів. Рекомендується переконатися, що всі розширення кортежу є дійсними.
  - webhooks.rules.apiGroups ([]string)
    Atomic: буде замінено під час злиття
    APIGroups — це групи API, до яких належать ресурси. '*' означає всі групи. Якщо присутній символ '*', довжина списку має бути одиницею. Обовʼязково.
  - webhooks.rules.apiVersions ([]string)
    Atomic: буде замінено під час злиття
    APIVersions — це версії API, до яких належать ресурси. '*' означає всі версії. Якщо присутній символ '*', довжина списку має бути одиницею. Обовʼязково.
  - webhooks.rules.operations ([]string)
    Atomic: буде замінено під час злиття
    Operations — це операції, які цікавлять вебхук допуску — CREATE, UPDATE, DELETE, CONNECT або * для всіх цих операцій і будь-яких майбутніх операцій допуску, які будуть додані. Якщо присутній символ '*', довжина списку має бути одиницею. Обовʼязково.
  - webhooks.rules.resources ([]string)
    Atomic: буде замінено під час злиття
    Resources — це список ресурсів, до яких застосовується це правило.
    Наприклад, 'pods' означає Podʼи, 'pods/log' означає субресурс логу Podʼів. '*' означає всі ресурси, але не субресурси. 'pods/*' означає всі субресурси Podʼів. '*/scale' означає всі субресурси масштабування. '*/*' означає всі ресурси та їх субресурси.
    Якщо присутній універсальний символ, правило валідації забезпечить відсутність перекриття ресурсів.
    Залежно від навколишнього обʼєкта, субресурси можуть бути недопустимими. Обовʼязково.
  - webhooks.rules.scope (string)
    scope визначає область застосування цього правила. Допустимі значення — "Cluster", "Namespaced" та "*" "Cluster" означає, що правило буде застосовано тільки до ресурсів на рівні кластера. API обʼєкти простору імен є ресурсами на рівні кластера. "Namespaced" означає, що правило буде застосовано тільки до ресурсів простору імен. "*" означає, що немає обмежень на область застосування. Субресурси відповідають області застосування свого батьківського ресурсу. Стандартне значення — "*".
- webhooks.timeoutSeconds (int32)
  TimeoutSeconds визначає тайм-аут для цього вебхука. Після закінчення тайм-ауту виклик вебхука буде проігноровано або виклик API завершиться невдачею залежно від політики відмови. Значення тайм-ауту має бути від 1 до 30 секунд. Стандартне значення — 10 секунд.

MutatingWebhookConfigurationList

MutatingWebhookConfigurationList — це список MutatingWebhookConfiguration.

apiVersion: admissionregistration.k8s.io/v1
kind: MutatingWebhookConfigurationList
metadata (ListMeta)
Стандартні метадані списку. Більше інформації: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
items ([]MutatingWebhookConfiguration), обовʼязково
Список MutatingWebhookConfiguration.

Операції

`get` отримати вказану MutatingWebhookConfiguration

HTTP запит

GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name}

Параметри

name (в шляху): string, обовʼязково
name of the MutatingWebhookConfiguration
pretty (в запиті): string
pretty

Відповідь

401: Unauthorized

`list` перелік або перегляд обʼєктів типу MutatingWebhookConfiguration

HTTP запит

GET /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations

Параметри

allowWatchBookmarks (в запиті): boolean
allowWatchBookmarks
continue (в запиті): string
continue
fieldSelector (в запиті): string
fieldSelector
labelSelector (в запиті): string
labelSelector
limit (в запиті): integer
limit
pretty (в запиті): string
pretty
resourceVersion (в запиті): string
resourceVersion
resourceVersionMatch (в запиті): string
resourceVersionMatch
sendInitialEvents (в запиті): boolean
sendInitialEvents
timeoutSeconds (в запиті): integer
timeoutSeconds
watch (в запиті): boolean
watch

Відповідь

200 (MutatingWebhookConfigurationList): OK

401: Unauthorized

`create` створення MutatingWebhookConfiguration

HTTP запит

POST /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations

Параметри

body: MutatingWebhookConfiguration, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
pretty (в запиті): string
pretty

Відповідь

201 (MutatingWebhookConfiguration): Created

202 (MutatingWebhookConfiguration): Accepted

401: Unauthorized

`update` заміна вказаної MutatingWebhookConfiguration

HTTP запит

PUT /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name}

Параметри

name (в шляху): string, обовʼязково
name of the MutatingWebhookConfiguration
body: MutatingWebhookConfiguration, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
pretty (в запиті): string
pretty

Відповідь

201 (MutatingWebhookConfiguration): Created

401: Unauthorized

`patch` часткове оновлення вказаної MutatingWebhookConfiguration

HTTP запит

PATCH /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name}

Параметри

name (в шляху): string, обовʼязково
name of the MutatingWebhookConfiguration
body: Patch, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
force (в запиті): boolean
force
pretty (в запиті): string
pretty

Відповідь

201 (MutatingWebhookConfiguration): Created

401: Unauthorized

`delete` видалення MutatingWebhookConfiguration

HTTP запит

DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations/{name}

Параметри

name (в шляху): string, обовʼязково
name of the MutatingWebhookConfiguration
body: DeleteOptions
dryRun (в запиті): string
dryRun
gracePeriodSeconds (в запиті): integer
gracePeriodSeconds
pretty (в запиті): string
pretty
propagationPolicy (в запиті): string
propagationPolicy

Відповідь

200 (Status): OK

202 (Status): Accepted

401: Unauthorized

`deletecollection` видалення колекції MutatingWebhookConfiguration

HTTP запит

DELETE /apis/admissionregistration.k8s.io/v1/mutatingwebhookconfigurations

Параметри

body: DeleteOptions
continue (в запиті): string
continue
dryRun (в запиті): string
dryRun
fieldSelector (в запиті): string
fieldSelector
gracePeriodSeconds (в запиті): integer
gracePeriodSeconds
labelSelector (в запиті): string
labelSelector
limit (в запиті): integer
limit
pretty (в запиті): string
pretty
propagationPolicy (в запиті): string
propagationPolicy
resourceVersion (в запиті): string
resourceVersion
resourceVersionMatch (в запиті): string
resourceVersionMatch
sendInitialEvents (в запиті): boolean
sendInitialEvents
timeoutSeconds (в запиті): integer
timeoutSeconds

Відповідь

200 (Status): OK

401: Unauthorized

5 - ValidatingWebhookConfiguration

ValidatingWebhookConfiguration описує конфігурацію та вебхук допуску, який приймає або відхиляє та об’єкт, не змінюючи його.

apiVersion: admissionregistration.k8s.io/v1

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

ValidatingWebhookConfiguration

ValidatingWebhookConfiguration описує конфігурацію вебхуку допуску, який приймає або відхиляє обʼєкт не змінюючи його.

apiVersion: admissionregistration.k8s.io/v1
kind: ValidatingWebhookConfiguration
metadata (ObjectMeta)
Стандартні метадані обʼєкта; Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata.
webhooks ([]ValidatingWebhook)
Patch strategy: обʼєднання за ключем name
Map: унікальні значення ключа name будуть збережені під час злиття
Webhooks — це список вебхуків і ресурсів та операцій, які вони зачіпають.
ValidatingWebhook описує вебхук допуску та ресурси й операції, до яких він застосовується.
- webhooks.admissionReviewVersions ([]string), обовʼязково
  Atomic: буде замінено під час злиття
  AdmissionReviewVersions — це впорядкований список бажаних версій AdmissionReview, які очікує вебхук. API сервер спробує використати першу версію у списку, яку він підтримує. Якщо жодна з версій, зазначених у цьому списку, не підтримується API сервером, валідація для цього обʼєкта зазнає невдачі. Якщо збережена конфігурація вебхука вказує дозволені версії та не включає жодних версій, відомих API серверу, виклики до вебхука зазнають невдачі і є предметом для застосування політики відмов.
- webhooks.clientConfig (WebhookClientConfig), обовʼязково
  ClientConfig визначає, як спілкуватися з вебхуком. Обовʼязково
  WebhookClientConfig містить інформацію для встановлення TLS-зʼєднання з вебхуком
  - webhooks.clientConfig.caBundle ([]byte)
    caBundle — це PEM-кодований набір сертифікатів CA, який буде використовуватися для перевірки сертифіката сервера вебхука. Якщо не вказано, використовуються системні корені довіри на API сервері.
  - webhooks.clientConfig.service (ServiceReference)
    service — це посилання на сервіс для цього вебхука. Необхідно вказати або service, або url.
    Якщо вебхук працює в межах кластера, тоді слід використовувати service.
    ServiceReference містить посилання на Service.legacy.k8s.io
    - webhooks.clientConfig.service.name (string), обовʼязково
      name — це імʼя сервісу. Обовʼязково
    - webhooks.clientConfig.service.namespace (string), обовʼязково
      namespace — це простір імен сервісу. Обовʼязково
    - webhooks.clientConfig.service.path (string)
      path — це необовʼязковий URL-шлях, який буде надіслано в будь-якому запиті до цього сервісу.
    - webhooks.clientConfig.service.port (int32)
    Якщо вказано, то це порт на сервісі, який є хостом вебхуку. Типово 443 для зворотної сумісності. port має бути дійсним номером порту (1-65535, включно).
  - webhooks.clientConfig.url (string)
    url вказує місце розташування вебхука в стандартній формі URL (scheme://host:port/path). Необхідно вказати або url, або service.
    host не повинен посилатися на сервіс, що працює в кластері; використовуйте поле service натомість. Хост може бути знайдений через зовнішній DNS в деяких серверах API (наприклад, kube-apiserver не може працювати з кластерним DNS, оскільки це було б порушенням розшарування). host може також бути IP-адресою.
    Зверніть увагу, що використання localhost або 127.0.0.1 як host є ризикованим, якщо ви не вживаєте великих заходів обережності, щоб запустити цей вебхук на всіх хостах, що запускають сервер API, який може потребувати викликів до цього вебхука. Такі встановлення, ймовірно, будуть непереносимими, тобто їх буде важко розгорнути в новому кластері.
    Схема повинна бути "https"; URL повинен починатися з "https://".
    Шлях є необовʼязковим, і, якщо він присутній, може бути будь-яким рядком, допустимим в URL. Ви можете використовувати шлях для передачі довільного рядка до вебхука, наприклад, ідентифікатора кластера.
    Спроба використання автентифікації користувача або базової автентифікації, наприклад, "user:password@", не дозволена. Також не дозволяються фрагменти ("#...") і параметри запиту ("?...").
- webhooks.name (string), обовʼязково
  Імʼя вебхука допуску. Імʼя повинно бути повністю кваліфікованим, наприклад, imagepolicy.kubernetes.io, де "imagepolicy" — це імʼя вебхука, а kubernetes.io — це імʼя організації. Обовʼязково.
- webhooks.sideEffects (string), обовʼязково
  SideEffects вказує, чи має цей вебхук побічні ефекти. Допустимі значення: None, NoneOnDryRun (вебхуки, створені у v1beta1, також можуть вказати Some або Unknown). Вебхуки з побічними ефектами МАЮТЬ реалізувати систему узгодження, оскільки запит може бути відхилено на наступному етапі ланцюжка допуску, і побічні ефекти потрібно буде скасувати. Запити з атрибутом dryRun автоматично відхиляються, якщо вони відповідають вебхуку з sideEffects == Unknown або Some.
- webhooks.failurePolicy (string)
  FailurePolicy визначає, як обробляються нерозпізнані помилки від точки доступу допуску — дозволені значення: Ignore або Fail. Стандартне значення — Fail.
- webhooks.matchConditions ([]MatchCondition)
  Patch strategy: обʼєднання за ключем name
  Map: під час обʼєднання будуть збережені унікальні значення за ключем name
MatchConditions — це список умов, які мають бути виконані для надсилання запиту до цього вебхука. Умови відповідності фільтрують запити, які вже були підібрані за правилами, namespaceSelector і objectSelector. Порожній список matchConditions відповідає всім запитам. Максимальна кількість умов відповідності — 64.
Логіка точного збігу така (за порядком): 1. Якщо БУДЬ-ЯКА умова відповідності оцінюється як FALSE, вебхук оминається. 2. Якщо ВСІ умови відповідності оцінюються як TRUE, вебхук викликається. 3. Якщо будь-яка умова відповідності оцінюється як помилка (але жодна не є FALSE): - Якщо failurePolicy=Fail, запит відхиляється - Якщо failurePolicy=Ignore, помилка ігнорується і вебхук оминається
MatchCondition представляє умову, яка повинна бути виконана для надсилання запиту до вебхука.
- webhooks.matchConditions.expression (string), обовʼязково
  Expression представляє вираз, який буде оцінено CEL. Результат обробки — bool. Вирази CEL мають доступ до вмісту AdmissionRequest і Authorizer, організованих у змінні CEL:
  'object' — Обʼєкт із вхідного запиту. Значення null для запитів DELETE. 'oldObject' — Наявний обʼєкт. Значення null для запитів CREATE. 'request' — Атрибути запиту допуску (/pkg/apis/admission/types.go#AdmissionRequest). 'authorizer' — CEL Authorizer. Може бути використано для виконання перевірок авторизації для виконавця (користувач або службового облікового запису) запиту. Див. https://pkg.go.dev/k8s.io/apiserver/pkg/cel/library#Authz 'authorizer.requestResource' — CEL ResourceCheck, створений з 'authorizer' і налаштований із ресурсом запиту. Документація щодо CEL: https://kubernetes.io/docs/reference/using-api/cel/
  Обовʼязково.
- webhooks.matchConditions.name (string), обовʼязково
  Name — це ідентифікатор цієї умови відповідності, використовується для стратегії злиття умов відповідності, а також для надання ідентифікатора для цілей логування. Хороша назва має бути описовою для повʼязаного виразу. Назва має бути кваліфікованою назвою, що складається з алфавітно-цифрових символів, '-', '' або '.', і має починатися та закінчуватися алфавітно-цифровим символом (наприклад, 'MyName' або 'my.name' або '123-abc', регулярний вираз, що використовується для перевірки, — '([A-Za-z0-9][-A-Za-z0-9.]*)?[A-Za-z0-9]') з необовʼязковим префіксом DNS субдомену та '/' (наприклад, 'example.com/MyName').
  Обовʼязково.
- webhooks.matchPolicy (string)
  matchPolicy визначає, як використовується список "rules" для відповідності вхідним запитам. Допустимі значення — "Exact" або "Equivalent".
  - Exact: відповідність запиту тільки в тому випадку, якщо він точно відповідає зазначеному правилу. Наприклад, якщо розгортання (deployments) можуть бути змінені через apps/v1, apps/v1beta1 і extensions/v1beta1, але "rules" включають тільки apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"], запит до apps/v1beta1 або extensions/v1beta1 не буде надіслано до вебхука.
  - Equivalent: відповідність запиту, якщо він змінює ресурс, вказаний у правилах, навіть через іншу групу API або версію. Наприклад, якщо розгортання (deployments) можуть бути змінені через apps/v1, apps/v1beta1 і extensions/v1beta1, і "rules" включають тільки apiGroups:["apps"], apiVersions:["v1"], resources: ["deployments"], запит до apps/v1beta1 або extensions/v1beta1 буде перетворений на apps/v1 і надісланий до вебхука.
  Стандартне значення — "Equivalent".
- webhooks.namespaceSelector (LabelSelector)
  NamespaceSelector визначає, чи буде вебхук працювати з обʼєктом на основі того, чи збігається простір імен для цього обʼєкта з селектором. Якщо обʼєкт сам є простором імен, перевірка збігу виконується за метаданими обʼєкта. Якщо обʼєкт є іншим ресурсом на рівні кластера, він ніколи не оминає вебхук.
  Наприклад, щоб запустити вебхук для будь-яких обʼєктів, чий простір імен не повʼязаний з "runlevel" 0 або 1, потрібно налаштувати селектор наступним чином:
```
"namespaceSelector": {
  "matchExpressions": [
    {
      "key": "runlevel",
      "operator": "NotIn",
      "values": [
        "0",
        "1"
      ]
    }
  ]
}
```
  Якщо замість цього ви хочете запустити вебхук для будь-яких обʼєктів, чий простір імен повʼязаний з "environment" "prod" або "staging", потрібно налаштувати селектор наступним чином:
```
"namespaceSelector": {
  "matchExpressions": [
    {
      "key": "environment",
      "operator": "In",
      "values": [
        "prod",
        "staging"
      ]
    }
  ]
}
```
  Див. https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/ для отримання додаткових прикладів селекторів міток.
  Типове значення — порожній LabelSelector, який має збіг зі всім.
- webhooks.objectSelector (LabelSelector)
  ObjectSelector визначає, чи буде вебхук працювати з обʼєктом на основі того, чи має обʼєкт відповідні мітки. ObjectSelector оцінюється як для oldObject, так і для newObject, які будуть надіслані до вебхука, і вважається відповідним, якщо будь-який з обʼєктів відповідає селектору. Нульовий обʼєкт (oldObject у випадку створення або newObject у випадку видалення) або обʼєкт, який не може мати міток (наприклад, DeploymentRollback або PodProxyOptions обʼєкт), не вважається таким, що має збіг. Використовуйте objectSelector лише якщо вебхук є опціональним, оскільки кінцеві користувачі можуть оминути вебхук допуску, встановивши мітки. Типове значення — порожній LabelSelector, який має збіг зі всім.
- webhooks.rules ([]RuleWithOperations)
  Atomic: буде замінено під час злиття
  Rules описують, які операції з якими ресурсами/субресурсами цікавлять вебхук. Вебхук цікавить операція, якщо вона збігаєтьсяз БУДЬ-ЯКИМ правилом. Однак, щоб запобігти ValidatingAdmissionWebhooks і MutatingAdmissionWebhooks від приведення кластера в стан, з якого не можна вийти без повного відключення втулка, ValidatingAdmissionWebhooks і MutatingAdmissionWebhooks ніколи не викликаються для запитів на допуск для обʼєктів ValidatingWebhookConfiguration і MutatingWebhookConfiguration.
  RuleWithOperations — це кортеж операцій і ресурсів. Рекомендується переконатися, що всі розширення кортежу є дійсними.
  - webhooks.rules.apiGroups ([]string)
    Atomic: буде замінено під час обʼєднання
    APIGroups — це групи API, до яких належать ресурси. '*' означає всі групи. Якщо присутній символ '*', довжина списку має бути одиницею. Обовʼязково.
  - webhooks.rules.apiVersions ([]string)
    Atomic: буде замінено під час обʼєднання
    APIVersions — це версії API, до яких належать ресурси. '*' означає всі версії. Якщо присутній символ '*', довжина списку має бути одиницею. Обовʼязково.
  - webhooks.rules.operations ([]string)
    Atomic: буде замінено під час обʼєднання
    Operations — це операції, які цікавлять вебхук допуску — CREATE, UPDATE, DELETE, CONNECT або * для всіх цих операцій і будь-яких майбутніх операцій допуску, які будуть додані. Якщо присутній символ '*', довжина списку має бути одиницею. Обовʼязково.
  - webhooks.rules.resources ([]string)
    Atomic: буде замінено під час обʼєднання
    Resources — це список ресурсів, до яких застосовується це правило.
    Наприклад, 'pods' означає Podʼи, 'pods/log' означає субресурс логу Podʼів. '*' означає всі ресурси, але не субресурси. 'pods/*' означає всі субресурси Podʼів. '*/scale' означає всі субресурси масштабування. '*/*' означає всі ресурси та їх субресурси.
    Якщо присутній універсальний символ, правило валідації забезпечить відсутність перекриття ресурсів.
    Залежно від навколишнього обʼєкта, субресурси можуть бути недопустимими. Обовʼязково.
  - webhooks.rules.scope (string)
    scope визначає область застосування цього правила. Допустимі значення — "Cluster", "Namespaced" та "*". "Cluster" означає, що правило буде застосовано тільки до ресурсів на рівні кластера. API обʼєкти простору імен є ресурсами на рівні кластера. "Namespaced" означає, що правило буде застосовано тільки до ресурсів простору імен. "*" означає, що немає обмежень на область застосування. Субресурси відповідають області застосування свого батьківського ресурсу. Стандартне значення — "*".
- webhooks.timeoutSeconds (int32)
  TimeoutSeconds визначає тайм-аут для цього вебхука. Після закінчення тайм-ауту виклик вебхука буде проігноровано або виклик API завершиться невдачею залежно від політики відмови. Значення тайм-ауту має бути від 1 до 30 секунд. Стандартне значення — 10 секунд.

ValidatingWebhookConfigurationList

ValidatingWebhookConfigurationList — це список ValidatingWebhookConfiguration.

items ([]ValidatingWebhookConfiguration), обовʼязково
Список ValidatingWebhookConfiguration.
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 (ListMeta)
Стандартні метадані списку. Докладніше: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

Операції

`get` отримати вказану ValidatingWebhookConfiguration

HTTP запит

GET /apis/admissionregistration.k8s.io/v1/validatingwebhookconfigurations/{name}

Параметри

name (в шляху): string, обовʼязково
назва ValidatingWebhookConfiguration
pretty (в запиті): string
pretty

Відповідь

401: Unauthorized

`list` перелік або перегляд обʼктів ValidatingWebhookConfiguration

HTTP запит

GET /apis/admissionregistration.k8s.io/v1/validatingwebhookconfigurations

Параметри

allowWatchBookmarks (в запиті): boolean
allowWatchBookmarks
continue (в запиті): string
continue
fieldSelector (в запиті): string
fieldSelector
labelSelector (в запиті): string
labelSelector
limit (в запиті): integer
limit
pretty (в запиті): string
pretty
resourceVersion (в запиті): string
resourceVersion
resourceVersionMatch (в запиті): string
resourceVersionMatch
sendInitialEvents (в запиті): boolean
sendInitialEvents
timeoutSeconds (в запиті): integer
timeoutSeconds
watch (в запиті): boolean
watch

Відповідь

200 (ValidatingWebhookConfigurationList): OK

401: Unauthorized

`create` створення ValidatingWebhookConfiguration

HTTP запит

POST /apis/admissionregistration.k8s.io/v1/validatingwebhookconfigurations

Параметри

body: ValidatingWebhookConfiguration, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
pretty (в запиті): string
pretty

Відповідь

201 (ValidatingWebhookConfiguration): Created

202 (ValidatingWebhookConfiguration): Accepted

401: Unauthorized

`update` заміна вказаної ValidatingWebhookConfiguration

HTTP запит

PUT /apis/admissionregistration.k8s.io/v1/validatingwebhookconfigurations/{name}

Параметри

name (в шляху): string, обовʼязково
назва ValidatingWebhookConfiguration
body: ValidatingWebhookConfiguration, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
pretty (в запиті): string
pretty

Відповідь

201 (ValidatingWebhookConfiguration): Created

401: Unauthorized

`patch` часткове оновлення вказаної ValidatingWebhookConfiguration

HTTP запит

PATCH /apis/admissionregistration.k8s.io/v1/validatingwebhookconfigurations/{name}

Параметри

name (в шляху): string, обовʼязково
назва ValidatingWebhookConfiguration
body: Patch, обовʼязково
dryRun (в запиті): string
dryRun
fieldManager (в запиті): string
fieldManager
fieldValidation (в запиті): string
fieldValidation
force (в запиті): boolean
force
pretty (в запиті): string
pretty

Відповідь