--- api_metadata: apiVersion: "scheduling.k8s.io/v1" import: "k8s.io/api/scheduling/v1" kind: "PriorityClass" content_type: "api_reference" description: "PriorityClass 定义了从优先级类名到优先级数值的映射。" title: "PriorityClass" weight: 13 auto_generated: false --- `apiVersion: scheduling.k8s.io/v1` `import "k8s.io/api/scheduling/v1"` ## PriorityClass {#PriorityClass} PriorityClass 定义了从优先级类名到优先级数值的映射。该值可以是任何有效的整数。

- **apiVersion**: scheduling.k8s.io/v1 - **kind**: PriorityClass - **metadata** (}}">ObjectMeta) 标准对象的元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata - **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。 ## PriorityClassList {#PriorityClassList} PriorityClassList 是优先级类的集合。

- **apiVersion**: scheduling.k8s.io/v1 - **kind**: PriorityClassList - **metadata** (}}">ListMeta) 标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata - **items** ([]}}">PriorityClass)，必需 items 是 PriorityClasses 的列表 ## 操作 {#Operations}

### `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 #### 参数 - **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 (}}">PriorityClassList): OK 401: Unauthorized ### `create` 创建一个 PriorityClass #### HTTP 请求 POST /apis/scheduling.k8s.io/v1/priorityclasses #### 参数 - **body**: }}">PriorityClass，必需 - **dryRun** （**查询参数**）：string }}">dryRun - **fieldManager** （**查询参数**）：string }}">fieldManager - **fieldValidation** （**查询参数**）：string }}">fieldValidation - **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 名称 - **body**: }}">PriorityClass，必需 - **dryRun** （**查询参数**）：string }}">dryRun - **fieldManager** （**查询参数**）：string }}">fieldManager - **fieldValidation** （**查询参数**）：string }}">fieldValidation - **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 名称 - **body**: }}">Patch，必需 - **dryRun** （**查询参数**）：string }}">dryRun - **fieldManager** （**查询参数**）：string }}">fieldManager - **fieldValidation** （**查询参数**）：string }}">fieldValidation - **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 名称。 - **body**: }}">DeleteOptions - **dryRun** （**查询参数**）：string }}">dryRun - **gracePeriodSeconds** （**查询参数**）：integer }}">gracePeriodSeconds - **pretty** （**查询参数**）：string }}">pretty - **propagationPolicy** （**查询参数**）：string }}">propagationPolicy #### 响应 200 (}}">Status): OK 202 (}}">Status): Accepted 401: Unauthorized ### `deletecollection` 删除 PriorityClass 集合 #### HTTP 请求 DELETE /apis/scheduling.k8s.io/v1/priorityclasses #### 参数 - **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