From 6a7d78ab967e6372e84e00818c52e6d6b62ce65a Mon Sep 17 00:00:00 2001 From: "zhenghao.zhu" Date: Tue, 16 May 2023 14:32:06 +0800 Subject: [PATCH] [zh] resync page csi-node-v1 --- .../csi-node-v1.md | 69 ++++++++++++++----- .../config-and-storage-resources/secret-v1.md | 54 +++++++++------ 2 files changed, 83 insertions(+), 40 deletions(-) diff --git a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/csi-node-v1.md b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/csi-node-v1.md index a05152e1c50..f0cafae20be 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/csi-node-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/csi-node-v1.md @@ -41,14 +41,15 @@ CSINode 包含指向相应节点对象的 OwnerReference。 - **metadata** (}}">ObjectMeta) - metadata.name 必须是 Kubernetes 节点的名称。 + 标准的对象元数据。metadata.name 必须是 Kubernetes 节点的名称。 - **spec** (}}">CSINodeSpec)，必需 @@ -66,7 +67,7 @@ CSINodeSpec 包含一个节点上安装的所有 CSI 驱动规约有关的信息 - **drivers** ([]CSINodeDriver), required *Patch strategy: merge on key `name`* - + drivers is a list of information of all CSI Drivers existing on a node. If all drivers in the list are uninstalled, this can become empty. @@ -74,25 +75,26 @@ CSINodeSpec 包含一个节点上安装的所有 CSI 驱动规约有关的信息 - **drivers.name** (string), required - This is the name of the CSI driver that this object refers to. This MUST be the same name returned by the CSI GetPluginName() call for that driver. + name represents the name of the CSI driver that this object refers to. This MUST be the same name returned by the CSI GetPluginName() call for that driver. --> - **drivers** ([]CSINodeDriver)，必需 **补丁策略：按照键 `name` 合并** - + drivers 是节点上存在的所有 CSI 驱动的信息列表。如果列表中的所有驱动均被卸载，则此字段可以为空。 - + **CSINodeDriver 包含一个节点上安装的一个 CSI 驱动规约有关的信息。** - + - **drivers.name** (string)，必需 - 这是该对象引用的 CSI 驱动的名称。此字段值必须是针对该驱动由 CSI GetPluginName() 调用返回的相同名称。 + name 表示该对象引用的 CSI 驱动的名称。此字段值必须是针对该驱动由 CSI GetPluginName() 调用返回的相同名称。 - + --> + - **drivers.nodeID** (string)，必需 从驱动角度来看，这是节点的 nodeID。 @@ -102,23 +104,28 @@ CSINodeSpec 包含一个节点上安装的所有 CSI 驱动规约有关的信息 它可以藉此字段使用存储系统所理解的 ID 引用节点名称，例如使用 “nodeA” 而不是 “node1”。 此字段是必需的。 - - - **drivers.allocatable.count** (int32) - Maximum number of unique volumes managed by the CSI driver that can be used on a node. A volume that is both attached and mounted on a node is considered to be used once, not twice. The same rule applies for a unique volume that is shared among multiple pods on the same node. If this field is not specified, then the supported number of volumes on this node is unbounded. ---> - **drivers.allocatable** (VolumeNodeResources) allocatable 表示一个节点上可供调度的卷资源。此字段处于 beta 阶段。 - + + **VolumeNodeResources 是调度卷时所用的一组资源限制。** - + + - **drivers.allocatable.count** (int32) 这是一个节点上可使用的、由 CSI 驱动管理的独立卷个数的上限。 @@ -126,11 +133,12 @@ CSINodeSpec 包含一个节点上安装的所有 CSI 驱动规约有关的信息 相同的规则适用于同一个节点上多个 Pod 之间共享的同一个卷。 如果未指定此字段，则该节点上支持的卷数量是无限的。 - + --> + - **drivers.topologyKeys** ([]string) topologyKeys 是驱动支持的键的列表。 @@ -181,6 +189,7 @@ CSINodeList 是 CSINode 对象的集合。
### `get` 读取指定的 CSINode + #### HTTP 请求 GET /apis/storage.k8s.io/v1/csinodes/{name} @@ -263,6 +272,10 @@ GET /apis/storage.k8s.io/v1/csinodes }}">resourceVersionMatch +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents + - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds @@ -297,6 +310,7 @@ POST /apis/storage.k8s.io/v1/csinodes - **pretty** (*in query*): string --> #### 参数 + - **body**: }}">CSINode，必需 - **dryRun** (**查询参数**): string @@ -332,6 +346,7 @@ POST /apis/storage.k8s.io/v1/csinodes #### HTTP Request --> ### `update` 替换指定的 CSINode + #### HTTP 请求 PUT /apis/storage.k8s.io/v1/csinodes/{name} @@ -347,6 +362,7 @@ PUT /apis/storage.k8s.io/v1/csinodes/{name} - **pretty** (*in query*): string --> #### 参数 + - **name** (**路径参数**): string，必需 CSINode 的名称 @@ -373,6 +389,7 @@ PUT /apis/storage.k8s.io/v1/csinodes/{name} #### Response --> #### 响应 + 200 (}}">CSINode): OK 201 (}}">CSINode): Created @@ -384,6 +401,7 @@ PUT /apis/storage.k8s.io/v1/csinodes/{name} #### HTTP Request --> ### `patch` 部分更新指定的 CSINode + #### HTTP 请求 PATCH /apis/storage.k8s.io/v1/csinodes/{name} @@ -400,6 +418,7 @@ PATCH /apis/storage.k8s.io/v1/csinodes/{name} - **pretty** (*in query*): string --> #### 参数 + - **name** (**路径参数**): string，必需 CSINode 的名称 @@ -430,6 +449,7 @@ PATCH /apis/storage.k8s.io/v1/csinodes/{name} #### Response --> #### 响应 + 200 (}}">CSINode): OK 201 (}}">CSINode): Created @@ -441,7 +461,9 @@ PATCH /apis/storage.k8s.io/v1/csinodes/{name} #### HTTP Request --> ### `delete` 删除 CSINode + #### HTTP 请求 + DELETE /apis/storage.k8s.io/v1/csinodes/{name} #### 响应 + 200 (}}">CSINode): OK 202 (}}">CSINode): Accepted @@ -492,7 +515,9 @@ DELETE /apis/storage.k8s.io/v1/csinodes/{name} #### HTTP Request --> ### `deletecollection` 删除 CSINode 的集合 + #### HTTP 请求 + DELETE /apis/storage.k8s.io/v1/csinodes #### 参数 + - **body**: }}">DeleteOptions - **continue** (**查询参数**): string @@ -553,6 +579,10 @@ DELETE /apis/storage.k8s.io/v1/csinodes }}">resourceVersionMatch +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents + - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds @@ -561,6 +591,7 @@ DELETE /apis/storage.k8s.io/v1/csinodes #### Response --> #### 响应 + 200 (}}">Status): OK -401: Unauthorized \ No newline at end of file +401: Unauthorized diff --git a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/secret-v1.md b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/secret-v1.md index 18251f251d0..5b02916de8d 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/secret-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/config-and-storage-resources/secret-v1.md @@ -44,13 +44,13 @@ data 字段值的总字节必须小于 MaxSecretSize 字节。 Data contains the secret data. Each key must consist of alphanumeric characters, '-', '_' or '.'. The serialized form of the secret data is a base64 encoded string, representing the arbitrary (possibly non-string) data value here. Described in https://tools.ietf.org/html/rfc4648#section-4 --> - **metadata** (}}">ObjectMeta) - + 标准的对象元数据。 更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata - **data** (map[string][]byte) - + data 包含秘密数据。 每个键必须由字母、数字、“-”、“_” 或 “.” 组成。 秘密数据的序列化格式是 base64 编码的字符串，表示此处的任意（可能是非字符串）数据值。 @@ -67,20 +67,20 @@ data 字段值的总字节必须小于 MaxSecretSize 字节。 Used to facilitate programmatic handling of secret data. More info: https://kubernetes.io/docs/concepts/configuration/secret/#secret-types --> - **immutable** (boolean) - + 如果 immutable 设为 true，则确保不会更新 Secret 中存储的数据（只能修改对象元数据）。 如果未设为 true，则可以随时修改此字段。 默认为 nil。 - **stringData** (map[string]string) - + stringData 允许指定字符串格式的非二进制秘密数据。 为了方便起见，它作为只写输入字段提供。 写入时将所有键和值合并到 data 字段，且覆盖任何现有的值。 从 API 读取时绝不会输出 stringData 字段。 - **type** (string) - + 用于满足程序化方式处理秘密数据。 更多信息： https://kubernetes.io/zh-cn/docs/concepts/configuration/secret/#secret-types @@ -108,13 +108,13 @@ SecretList 是 Secret 的列表。 Items is a list of secret objects. More info: https://kubernetes.io/docs/concepts/configuration/secret --> - **metadata** (}}">ListMeta) - + 标准的列表元数据。 更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds - **items** ([]}}">Secret)，必需 - + items 是 Secret 对象的列表。 更多信息： https://kubernetes.io/zh-cn/docs/concepts/configuration/secret @@ -148,15 +148,15 @@ GET /api/v1/namespaces/{namespace}/secrets/{name} #### 参数 - **name** (**路径参数**): string，必需 - + Secret 的名称 - **namespace** (**路径参数**): string，必需 - + }}">namespace - **pretty** (**查询参数**): string - + }}">pretty