PriorityClass

PriorityClass 定义了从优先级类名到优先级数值的映射。

apiVersion: scheduling.k8s.io/v1

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

PriorityClass

PriorityClass 定义了从优先级类名到优先级数值的映射。 该值可以是任何有效的整数。

  • apiVersion: scheduling.k8s.io/v1

  • kind: PriorityClass

  • value （int32），必需

    value 表示此优先级的整数值。这是 Pod 在其 Pod 规约中有此类名称时收到的实际优先级。

  • description (string)

    description 是一个任意字符串，通常提供有关何时应使用此优先级的指南。

  • globalDefault (boolean)

    globalDefault 指定是否应将此 PriorityClass 视为没有任何优先级类的 Pod 的默认优先级。 只有一个 PriorityClass 可以标记为 globalDefault。 但是，如果存在多个 PriorityClasses 且其 globalDefault 字段设置为 true， 则将使用此类全局默认 PriorityClasses 的最小值作为默认优先级。

  • preemptionPolicy (string)

    preemptionPolicy 是与抢占优先级较低的 Pod 相关的策略。 可选值：Never、PreemptLowerPriority。 如果未设置，则默认为 PreemptLowerPriority。

    可能的枚举值：

    • "Never" 表示 Pod 永远不会抢占具有较低优先级的其他 Pod。
    • "PreemptLowerPriority" 表示 Pod 可以抢占具有较低优先级的其他 Pod。

PriorityClassList

PriorityClassList 是优先级类的集合。

  • apiVersion: scheduling.k8s.io/v1

  • kind: PriorityClassList

  • items ([]PriorityClass)，必需

    items 是 PriorityClass 的列表。

操作

get 读取特定的 PriorityClass

HTTP 请求

GET /apis/scheduling.k8s.io/v1/priorityclasses/{name}

参数

  • name （路径参数）: string，必需

    PriorityClass 的名称。

  • pretty （查询参数）：string

    pretty

响应

200 (PriorityClass): OK

401: Unauthorized

list 列出或观察 PriorityClass类的对象

HTTP 请求

GET /apis/scheduling.k8s.io/v1/priorityclasses

参数

  • continue（查询参数）：string

    continue

  • limit（查询参数）：integer

    limit

  • pretty（查询参数）：string

    pretty

  • watch（查询参数）：boolean

    watch

响应

200 (PriorityClassList): OK

401: Unauthorized

create 创建一个 PriorityClass

HTTP 请求

POST /apis/scheduling.k8s.io/v1/priorityclasses

参数

  • dryRun（查询参数）：string

    dryRun

  • pretty（查询参数）：string

    pretty

响应

200 (PriorityClass): OK

201 (PriorityClass): Created

202 (PriorityClass): Accepted

401: Unauthorized

update 替换指定的 PriorityClass

HTTP 请求

PUT /apis/scheduling.k8s.io/v1/priorityclasses/{name}

参数

  • name（路径参数）: string，必需

    PriorityClass 的名称。

  • dryRun（查询参数）：string

    dryRun

  • pretty（查询参数）：string

    pretty

响应

200 (PriorityClass): OK

201 (PriorityClass): Created

401: Unauthorized

patch 部分更新特定的 PriorityClass

HTTP 请求

PATCH /apis/scheduling.k8s.io/v1/priorityclasses/{name}

参数

  • name（路径参数）: string，必需

    PriorityClass 的名称。

  • dryRun（查询参数）：string

    dryRun

  • force（查询参数）：boolean

    force

  • pretty（查询参数）：string

    pretty

响应

200 (PriorityClass): OK

201 (PriorityClass): Created

401: Unauthorized

delete 删除一个 PriorityClass

HTTP 请求

DELETE /apis/scheduling.k8s.io/v1/priorityclasses/{name}

参数

  • name（路径参数）: string，必需

    PriorityClass 名称。

  • dryRun（查询参数）：string

    dryRun

  • pretty（查询参数）：string

    pretty

响应

200 (Status): OK

202 (Status): Accepted

401: Unauthorized

deletecollection 删除 PriorityClass 集合

HTTP 请求

DELETE /apis/scheduling.k8s.io/v1/priorityclasses

参数

  • continue（查询参数）：string

    continue

  • dryRun（查询参数）：string

    dryRun

  • limit（查询参数）：integer

    limit

  • pretty（查询参数）：string

    pretty

响应

200 (Status): OK

401: Unauthorized

最后修改 November 16, 2025 at 10:17 PM PST: [zh-cn]sync priority-class-v1 (4120b378d3)