CSINode

CSINode 保存关于节点上安装的所有 CSI 驱动程序的信息。

apiVersion: storage.k8s.io/v1

import "k8s.io/api/storage/v1"

CSINode

CSINode 保存关于节点上安装的所有 CSI 驱动程序的信息。CSI 驱动程序不需要直接创建 CSINode 对象。只要它们使用 node-driver-registrar sidecar 容器,kubelet 将在 kubelet 插件注册过程中自动为 CSI 驱动程序填充 CSINode 对象。CSINode 的名称与节点名称相同。如果对象丢失,则表示节点上没有可用的 CSI 驱动程序,或者 Kubelet 版本太低,无法创建此对象。CSINode 具有指向相应节点对象的 OwnerReference。


  • apiVersion:storage.k8s.io/v1

  • kind:CSINode

  • metadataObjectMeta

    标准对象的元数据。metadata.name 必须是 Kubernetes 节点名称。

  • specCSINodeSpec),必需

    spec 是 CSINode 的规范

CSINodeSpec

CSINodeSpec 保存关于节点上安装的所有 CSI 驱动程序的规范信息


  • drivers([]CSINodeDriver),必需

    补丁策略:合并时使用键 name

    映射:在合并期间,将保留键 name 的唯一值

    drivers 是节点上存在的所有 CSI 驱动程序的信息列表。如果列表中的所有驱动程序都被卸载,则此列表可以为空。

    CSINodeDriver 保存关于节点上安装的一个 CSI 驱动程序的规范信息

    • drivers.name(string),必需

      name 表示此对象引用的 CSI 驱动程序的名称。这必须与该驱动程序的 CSI GetPluginName() 调用返回的名称相同。

    • drivers.nodeID(string),必需

      从驱动程序的角度来看,节点的 nodeID。此字段使 Kubernetes 能够与节点命名不相同的存储系统进行通信。例如,Kubernetes 可以将给定的节点称为“node1”,但是存储系统可以将同一个节点称为“nodeA”。当 Kubernetes 向存储系统发出命令以将卷附加到特定节点时,可以使用此字段来使用存储系统将理解的 ID 来引用节点名称,例如 “nodeA” 而不是 “node1”。此字段是必需的。

    • drivers.allocatable(VolumeNodeResources)

      allocatable 表示可用于调度的节点的卷资源。此字段为 beta 版。

      VolumeNodeResources 是一组用于调度卷的资源限制。

      • drivers.allocatable.count(int32)

        count 表示由 CSI 驱动程序管理的可以在节点上使用的唯一卷的最大数量。一个附加和挂载在节点上的卷被视为使用一次,而不是两次。对于在同一节点上的多个 Pod 之间共享的唯一卷也适用相同的规则。如果未指定此字段,则此节点上支持的卷数是无限制的。

    • drivers.topologyKeys([]string)

      原子:将在合并期间被替换

      topologyKeys 是驱动程序支持的键的列表。当驱动程序在集群上初始化时,它会提供一组它理解的拓扑键(例如,“company.com/zone”、“company.com/region”)。当驱动程序在节点上初始化时,它会提供相同的拓扑键以及值。Kubelet 会将这些拓扑键作为标签公开在其自己的节点对象上。当 Kubernetes 执行拓扑感知配置时,可以使用此列表来确定它应该从节点对象中检索哪些标签并传递回驱动程序。不同的节点可以使用不同的拓扑键。如果驱动程序不支持拓扑,则此列表可以为空。

CSINodeList

CSINodeList 是 CSINode 对象的集合。


操作


get 读取指定的 CSINode

HTTP 请求

GET /apis/storage.k8s.io/v1/csinodes/{name}

参数

  • name在路径中):字符串,必需

    CSINode 的名称

  • pretty在查询中):字符串

    pretty

响应

200(CSINode):成功

401:未授权

list 列出或监视 CSINode 类型的对象

HTTP 请求

GET /apis/storage.k8s.io/v1/csinodes

参数

响应

200(CSINodeList):成功

401:未授权

create 创建一个 CSINode

HTTP 请求

POST /apis/storage.k8s.io/v1/csinodes

参数

响应

200(CSINode):成功

201(CSINode):已创建

202(CSINode):已接受

401:未授权

update 替换指定的 CSINode

HTTP 请求

PUT /apis/storage.k8s.io/v1/csinodes/{name}

参数

  • name在路径中):字符串,必需

    CSINode 的名称

  • bodyCSINode,必需

  • dryRun在查询中):字符串

    dryRun

  • fieldManager在查询中):字符串

    fieldManager

  • fieldValidation在查询中):字符串

    fieldValidation

  • pretty在查询中):字符串

    pretty

响应

200(CSINode):成功

201(CSINode):已创建

401:未授权

patch 部分更新指定的 CSINode

HTTP 请求

PATCH /apis/storage.k8s.io/v1/csinodes/{name}

参数

  • name在路径中):字符串,必需

    CSINode 的名称

  • bodyPatch,必需

  • dryRun在查询中):字符串

    dryRun

  • fieldManager在查询中):字符串

    fieldManager

  • fieldValidation在查询中):字符串

    fieldValidation

  • force在查询中):布尔值

    force

  • pretty在查询中):字符串

    pretty

响应

200(CSINode):成功

201(CSINode):已创建

401:未授权

delete 删除一个 CSINode

HTTP 请求

DELETE /apis/storage.k8s.io/v1/csinodes/{name}

参数

响应

200(CSINode):成功

202(CSINode):已接受

401:未授权

deletecollection 删除 CSINode 的集合

HTTP 请求

DELETE /apis/storage.k8s.io/v1/csinodes

参数

响应

200(Status):成功

401:未授权

此页面是自动生成的。

如果您计划报告此页面的问题,请在您的问题描述中说明该页面是自动生成的。该修复可能需要在 Kubernetes 项目的其他地方进行。

上次修改时间为 2024 年 8 月 28 日下午 6:01 PST:更新 v1.31 的生成的 API 参考 (8ba98c79c1)