ResourceClass v1alpha2

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

apiVersion: resource.k8s.io/v1alpha2

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

ResourceClass

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

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


  • apiVersion: resource.k8s.io/v1alpha2

  • kind: ResourceClass

  • metadata (ObjectMeta)

    Стандартні метадані обʼєкта.

  • driverName (string), обовʼязково

    DriverName визначає імʼя динамічного драйвера ресурсів, який використовується для виділення ResourceClaim, що використовує цей клас.

    Ресурсні драйвери мають унікальне імʼя у прямому порядку домену (acme.example.com).

  • parametersRef (ResourceClassParametersReference)

    ParametersRef посилається на довільний окремий обʼєкт, який може містити параметри, які будуть використані драйвером при виділенні ресурсу, що використовує цей клас. Динамічний драйвер ресурсів може відрізняти параметри, збережені тут, від тих, що зберігаються в ResourceClaimSpec.

    ResourceClassParametersReference містить достатньо інформації для пошуку параметрів ResourceClass.

    • parametersRef.kind (string), обовʼязково

      Kind — це тип ресурсу, на який робиться посилання. Це те саме значення, що й у метаданих обʼєкта параметрів.

    • parametersRef.name (string), обовʼязково

      Name — це назва ресурсу, на який робиться посилання.

    • parametersRef.apiGroup (string)

      APIGroup — це група для ресурсу, на який робиться посилання. Вона порожня для основного API. Це відповідає групі в APIVersion, яке використовується при створенні ресурсів.

    • parametersRef.namespace (string)

      Namespace — це простір імен, який містить ресурс, на який робиться посилання. Для ресурсів з областю видимості на рівні кластера повинно бути порожнім, а для ресурсів з іменованою областю видимості — непорожнім.

  • suitableNodes (NodeSelector)

    Тільки вузли, що відповідають селектору, будуть враховані планувальником при спробі знайти вузол, який підходить для Pod, коли цей Pod використовує ResourceClaim, який ще не був виділений.

    Налаштування цього поля є необовʼязковим. Якщо воно null, всі вузли є кандидатами.

    Селектор вузла представляє обʼєднання результатів одного або декількох запитів міток на заданий набір вузлів; іншими словами, він представляє OR селекторів, які представлені термінами селектора вузла.

    • suitableNodes.nodeSelectorTerms ([]NodeSelectorTerm), обовʼязково

      Обовʼязково. Список термінів селектора вузла. Терміни є обʼєднані за допомогою OR.

      Null або порожній термін селектора вузла не відповідає жодному обʼєкту. Вимоги є AND. Тип TopologySelectorTerm реалізує підмножину NodeSelectorTerm.

      • suitableNodes.nodeSelectorTerms.matchExpressions ([]NodeSelectorRequirement)

        Список вимог селектора вузла за мітками вузлів.

      • suitableNodes.nodeSelectorTerms.matchFields ([]NodeSelectorRequirement)

        Список вимог селектора вузла за полями вузлів.

ResourceClassList

ResourceClassList є колекцією класів.


  • apiVersion: resource.k8s.io/v1alpha2

  • kind: ResourceClassList

  • metadata (ListMeta)

    Стандартні метадані списку

  • items ([]ResourceClass), обовʼязково

    Список класів ресурсів.

Операції


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

HTTP запит

GET /apis/resource.k8s.io/v1alpha2/resourceclasses/{name}

Параметри

  • name (в шляху): string, обовʼязково

    імʼя ResourceClass

  • pretty (в запиті): string

    pretty

Відповідь

200 (ResourceClass): OK

401: Unauthorized

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

HTTP запит

GET /apis/resource.k8s.io/v1alpha2/resourceclasses

Параметри

Відповідь

200 (ResourceClassList): OK

401: Unauthorized

create створення ResourceClass

HTTP запит

POST /apis/resource.k8s.io/v1alpha2/resourceclasses

Параметри

Відповідь

200 (ResourceClass): OK

201 (ResourceClass): Created

202 (ResourceClass): Accepted

401: Unauthorized

update заміна вказаного ResourceClass

HTTP запит

PUT /apis/resource.k8s.io/v1alpha2/resourceclasses/{name}

Параметри

  • name (в шляху): string, обовʼязково

    імʼя ResourceClass

  • body: ResourceClass, обовʼязково

  • dryRun (в запиті): string

    dryRun

  • fieldManager (в запиті): string

    fieldManager

  • fieldValidation (в запиті): string

    fieldValidation

  • pretty (в запиті): string

    pretty

Відповідь

200 (ResourceClass): OK

201 (ResourceClass): Created

401: Unauthorized

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

HTTP запит

PATCH /apis/resource.k8s.io/v1alpha2/resourceclasses/{name}

Параметри

  • name (в шляху): string, обовʼязково

    імʼя ResourceClass

  • body: Patch, обовʼязково

  • dryRun (в запиті): string

    dryRun

  • fieldManager (в запиті): string

    fieldManager

  • fieldValidation (в запиті): string

    fieldValidation

  • force (в запиті): boolean

    force

  • pretty (в запиті): string

    pretty

Відповідь

200 (ResourceClass): OK

201 (ResourceClass): Created

401: Unauthorized

delete видалення ResourceClass

HTTP запит

DELETE /apis/resource.k8s.io/v1alpha2/resourceclasses/{name}

Параметри

Відповідь

200 (ResourceClass): OK

202 (ResourceClass): Accepted

401: Unauthorized

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

HTTP запит

DELETE /apis/resource.k8s.io/v1alpha2/resourceclasses

Параметри

Відповідь

200 (Status): OK

401: Unauthorized

Змінено June 20, 2024 at 12:44 PM PST: Sync changest from andygol/k8s-website (36d05bc8a1)