--- api_metadata: apiVersion: "scheduling.k8s.io/v1" import: "k8s.io/api/scheduling/v1" kind: "PriorityClass" content_type: "api_reference" description: "PriorityClass 定义从优先级类名到优先级数值的映射。" title: "PriorityClass" weight: 15 --- `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 - **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。 - **value** （int32），必需 `value` 表示此优先级的整数值。这是 Pod 在其 Pod 规约中有此类名称时收到的实际优先级。 ## 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` 是 PriorityClass 的列表。 ## 操作 {#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 - **shardSelector** (**查询参数**): string }}">shardSelector - **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 - **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean }}">ignoreStoreReadErrorWithClusterBreakingPotential - **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 - **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean }}">ignoreStoreReadErrorWithClusterBreakingPotential - **labelSelector**（**查询参数**）：string }}">labelSelector - **limit**（**查询参数**）：integer }}">limit - **pretty**（**查询参数**）：string }}">pretty - **propagationPolicy**（**查询参数**）：string }}">propagationPolicy - **resourceVersion** （**查询参数**）：string }}">resourceVersion - **resourceVersionMatch** （**查询参数**）：string }}">resourceVersionMatch - **sendInitialEvents** (**查询参数**): boolean }}">sendInitialEvents - **shardSelector** (**查询参数**): string }}">shardSelector - **timeoutSeconds** （**查询参数**）：integer }}">timeoutSeconds #### 响应 200 (}}">Status): OK 401: Unauthorized