diff --git a/content/zh/docs/reference/kubernetes-api/workload-resources/priority-class-v1.md b/content/zh/docs/reference/kubernetes-api/workload-resources/priority-class-v1.md new file mode 100644 index 0000000000..3c75e674ca --- /dev/null +++ b/content/zh/docs/reference/kubernetes-api/workload-resources/priority-class-v1.md @@ -0,0 +1,811 @@ +--- +api_metadata: + apiVersion: "scheduling.k8s.io/v1" + import: "k8s.io/api/scheduling/v1" + kind: "PriorityClass" +content_type: "api_reference" +description: "PriorityClass 定义了从优先级类名到优先级数值的映射。" +title: "PriorityClass" +weight: 14 +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),必需 + + 此优先级的值。这是 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 + + +- **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 + + +- **timeoutSeconds** (*查询参数*): integer + + }}">timeoutSeconds + + +#### 响应 + +200 (}}">Status): OK + +401: Unauthorized +