From 6bf10e87025ceb6a856fefc7f6761520f355bd74 Mon Sep 17 00:00:00 2001 From: windsonsea Date: Sun, 6 Oct 2024 20:58:24 +0800 Subject: [PATCH] [zh] Sync config-and-storage-resources/storage-class-v1.md --- .../storage-class-v1.md | 102 ++++++++++++++---- 1 file changed, 80 insertions(+), 22 deletions(-) diff --git a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/storage-class-v1.md b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/storage-class-v1.md index bfb5910c913e5..1b84faaa8dd89 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/storage-class-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/storage-class-v1.md @@ -6,7 +6,7 @@ api_metadata: content_type: "api_reference" description: "StorageClass 为可以动态制备 PersistentVolume 的存储类描述参数。" title: "StorageClass" -weight: 6 +weight: 8 --- `apiVersion: storage.k8s.io/v1` @@ -24,6 +25,7 @@ weight: 6 `import "k8s.io/api/storage/v1"` ## StorageClass {#StorageClass} + - **metadata** (}}">ObjectMeta) @@ -64,6 +69,7 @@ StorageClass 是不受名字空间作用域限制的；按照 etcd 设定的存 + + - **allowedTopologies.matchLabelExpressions** ([]TopologySelectorLabelRequirement) + + **原子性：将在合并期间被替换** + + 按标签设置的拓扑选择器要求的列表。 + + + **拓扑选择器要求是与给定标签匹配的一个选择器。这是一个 Alpha 特性，将来可能会变更。** + - - **allowedTopologies.matchLabelExpressions** ([]TopologySelectorLabelRequirement) + --> - 按标签设置的拓扑选择器要求的列表。 - - - **拓扑选择器要求是与给定标签匹配的一个选择器。此功能为 Alpha 特性，将来可能会变更。** - - **allowedTopologies.matchLabelExpressions.key** (string)，必需 选择器所针对的标签键。 - + - **allowedTopologies.matchLabelExpressions.values** ([]string)，必需 - 字符串数组。一个值必须与要选择的标签匹配。values 中的每个条目按逻辑或的关系来计算。 + **原子性：将在合并期间被替换** + + 字符串值的数组。一个值必须与要选择的标签匹配。values 中的每个条目按逻辑或的关系来计算。 - **mountOptions** ([]string) - mountOptions 控制此存储类动态制备的 PersistentVolume 的挂载配置。 - （例如 ["ro", "soft"]）。 - 系统对选项作检查——如果有一个选项无效，则这些 PV 的挂载将失败。 + **原子性：将在合并期间被替换** + + mountOptions 控制此存储类动态制备的 PersistentVolume 的挂载配置，例如 ["ro", "soft"]。 + 针对此字段无合法性检查 —— 如果有一个选项无效，则这些 PV 的挂载将失败。 - **parameters** (map[string]string) @@ -134,6 +160,7 @@ StorageClass 是不受名字空间作用域限制的；按照 etcd 设定的存 reclaimPolicy controls the reclaimPolicy for dynamically provisioned PersistentVolumes of this storage class. Defaults to Delete. - **volumeBindingMode** (string) + volumeBindingMode indicates how PersistentVolumeClaims should be provisioned and bound. When unset, VolumeBindingImmediate is used. This field is only honored by servers that enable the VolumeScheduling feature. --> - **reclaimPolicy** (string) @@ -147,6 +174,7 @@ StorageClass 是不受名字空间作用域限制的；按照 etcd 设定的存 只有启用 VolumeScheduling 功能特性的服务器才能使用此字段。 ## StorageClassList {#StorageClassList} + @@ -160,9 +188,11 @@ StorageClassList 是存储类的集合。 - **metadata** (}}">ListMeta) @@ -184,7 +214,9 @@ StorageClassList 是存储类的集合。
### `get` 读取指定的 StorageClass + #### HTTP 请求 + GET /apis/storage.k8s.io/v1/storageclasses/{name} #### 参数 + - **name** (**路径参数**): string，必需 - StorageClass 的名称 + StorageClass 的名称。 - **pretty** (**查询参数**): string @@ -206,6 +239,7 @@ GET /apis/storage.k8s.io/v1/storageclasses/{name} #### Response --> #### 响应 + 200 (}}">StorageClass): OK 401: Unauthorized @@ -215,7 +249,9 @@ GET /apis/storage.k8s.io/v1/storageclasses/{name} #### HTTP Request --> ### `list` 列出或观测类别为 StorageClass 的对象 + #### HTTP 请求 + GET /apis/storage.k8s.io/v1/storageclasses #### 参数 + - **allowWatchBookmarks** (**查询参数**): boolean }}">allowWatchBookmarks @@ -280,6 +317,7 @@ GET /apis/storage.k8s.io/v1/storageclasses #### Response --> #### 响应 + 200 (}}">StorageClassList): OK 401: Unauthorized @@ -289,7 +327,9 @@ GET /apis/storage.k8s.io/v1/storageclasses #### HTTP Request --> ### `create` 创建 StorageClass + #### HTTP 请求 + POST /apis/storage.k8s.io/v1/storageclasses #### 参数 + - **body**: }}">StorageClass，必需 - **dryRun** (**查询参数**): string @@ -323,6 +364,7 @@ POST /apis/storage.k8s.io/v1/storageclasses #### Response --> #### 响应 + 200 (}}">StorageClass): OK 201 (}}">StorageClass): Created @@ -336,7 +378,9 @@ POST /apis/storage.k8s.io/v1/storageclasses #### HTTP Request --> ### `update` 替换指定的 StorageClass + #### HTTP 请求 + PUT /apis/storage.k8s.io/v1/storageclasses/{name} #### 参数 + - **name** (**路径参数**): string，必需 - StorageClass 的名称 + StorageClass 的名称。 - **body**: }}">StorageClass，必需 @@ -376,6 +421,7 @@ PUT /apis/storage.k8s.io/v1/storageclasses/{name} #### Response --> #### 响应 + 200 (}}">StorageClass): OK 201 (}}">StorageClass): Created @@ -387,7 +433,9 @@ PUT /apis/storage.k8s.io/v1/storageclasses/{name} #### HTTP Request --> ### `patch` 部分更新指定的 StorageClass + #### HTTP 请求 + PATCH /apis/storage.k8s.io/v1/storageclasses/{name} #### 参数 + - **name** (**路径参数**): string，必需 - StorageClass 的名称 + StorageClass 的名称。 - **body**: }}">Patch，必需 @@ -432,6 +481,7 @@ PATCH /apis/storage.k8s.io/v1/storageclasses/{name} #### Response --> #### 响应 + 200 (}}">StorageClass): OK 201 (}}">StorageClass): Created @@ -443,7 +493,9 @@ PATCH /apis/storage.k8s.io/v1/storageclasses/{name} #### HTTP Request --> ### `delete` 删除 StorageClass + #### HTTP 请求 + DELETE /apis/storage.k8s.io/v1/storageclasses/{name} #### 参数 + - **name** (**路径参数**): string，必需 - StorageClass 的名称 + StorageClass 的名称。 - **body**: }}">DeleteOptions @@ -483,6 +536,7 @@ DELETE /apis/storage.k8s.io/v1/storageclasses/{name} #### Response --> #### 响应 + 200 (}}">StorageClass): OK 202 (}}">StorageClass): Accepted @@ -494,7 +548,9 @@ DELETE /apis/storage.k8s.io/v1/storageclasses/{name} #### HTTP Request --> ### `deletecollection` 删除 StorageClass 的集合 + #### HTTP 请求 + DELETE /apis/storage.k8s.io/v1/storageclasses #### 参数 + - **body**: }}">DeleteOptions - **continue** (**查询参数**): string @@ -567,6 +624,7 @@ DELETE /apis/storage.k8s.io/v1/storageclasses #### Response --> #### 响应 + 200 (}}">Status): OK 401: Unauthorized