CSIStorageCapacity

CSIStorageCapacity 存储一个 CSI GetCapacity 调用的结果。

apiVersion: storage.k8s.io/v1

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

CSIStorageCapacity

CSIStorageCapacity 存储一个 CSI GetCapacity 调用的结果。 对于给定的 StorageClass，这描述了特定拓扑段中的可用容量。 这可以在考虑在何处实例化新的 PersistentVolume 时使用。

例如，这可以表达如下内容： - StorageClass “standard” 在 “topology.kubernetes.io/zone=us-east1” 中有 “1234 GiB” 可用 - StorageClass “localssd” 在 “kubernetes.io/hostname=knode-abc123” 中有 “10 GiB” 可用

以下三种情况都意味着对于特定组合没有可用容量：- 不存在具有合适拓扑和存储类名称的对象 - 存在此类对象，但未设置容量 - 存在此类对象，但容量为零

这些对象的生产者可以决定哪种方法更合适。

当 CSI 驱动程序选择使用 CSIDriverSpec.StorageCapacity 进行容量感知调度时，kube-scheduler 会使用这些对象。调度器将 MaximumVolumeSize 与挂起卷的请求大小进行比较，以筛选出不合适的节点。如果未设置 MaximumVolumeSize，它将回退到与不太精确的 Capacity 进行比较。如果也未设置，则调度器会假定容量不足并尝试其他节点。

  • apiVersion: storage.k8s.io/v1

  • kind: CSIStorageCapacity

  • metadata (ObjectMeta)

    标准对象的元数据。 名称没有特定含义。 它必须是一个 DNS 子域（允许点号，253 个字符）。 为了确保集群中没有与其他 CSI 驱动程序冲突，建议使用 csisc-<uuid>、生成的名称或以唯一 CSI 驱动程序名称结尾的反向域名。

    对象是命名空间的。

    更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

  • storageClassName (字符串)，必需

    storageClassName 表示报告的容量所应用的 StorageClass 的名称。 它必须满足与 StorageClass 对象名称相同的要求（非空、DNS 子域）。 如果该对象不再存在，则 CSIStorageCapacity 对象已过时，应由其创建者删除。 此字段是不可变的。

  • capacity (Quantity)

    capacity 是 CSI 驱动程序在其 GetCapacityResponse 中为具有匹配先前字段的拓扑和参数的 GetCapacityRequest 报告的值。

    语义目前（CSI 规范 1.2）定义为：可用于配置卷的存储的可用容量（以字节为单位）。 如果未设置，则当前无法获得该信息。

  • maximumVolumeSize (Quantity)

    maximumVolumeSize 是 CSI 驱动程序在其 GetCapacityResponse 中为具有匹配先前字段的拓扑和参数的 GetCapacityRequest 报告的值。

    从 CSI 规范 1.4.0 开始，将其定义为在 CreateVolumeRequest.capacity_range.required_bytes 字段中可使用的最大大小，以创建与 GetCapacityRequest 中具有相同参数的卷。 Kubernetes API 中的对应值是卷声明中的 ResourceRequirements.Requests。

  • nodeTopology (LabelSelector)

    nodeTopology 定义哪些节点可以访问报告容量的存储。如果未设置，则群集中任何节点都无法访问该存储。 如果为空，则所有节点都可以访问该存储。 此字段是不可变的。

CSIStorageCapacityList

CSIStorageCapacityList 是 CSIStorageCapacity 对象的集合。

操作

get 读取指定的 CSIStorageCapacity

HTTP 请求

GET /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name}

参数

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

    CSIStorageCapacity 的名称

  • namespace (在路径中): 字符串，必需

    命名空间

  • pretty (在查询中): 字符串

    pretty

响应

200 (CSIStorageCapacity): 正常

401: 未授权

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

HTTP 请求

GET /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities

参数

响应

200 (CSIStorageCapacityList): 正常

401: 未授权

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

HTTP 请求

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

参数

响应

200 (CSIStorageCapacityList): 正常

401: 未授权

create 创建一个 CSIStorageCapacity

HTTP 请求

POST /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities

参数

响应

200 (CSIStorageCapacity): 正常

201 (CSIStorageCapacity): 已创建

202 (CSIStorageCapacity): 已接受

401: 未授权

update 替换指定的 CSIStorageCapacity

HTTP 请求

PUT /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name}

参数

响应

200 (CSIStorageCapacity): 正常

201 (CSIStorageCapacity): 已创建

401: 未授权

patch 部分更新指定的 CSIStorageCapacity

HTTP 请求

PATCH /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name}

参数

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

    CSIStorageCapacity 的名称

  • namespace (在路径中): 字符串，必需

    命名空间

  • body: Patch，必需

  • dryRun (在查询中): 字符串

    dryRun

  • fieldManager (在查询中): 字符串

    fieldManager

  • fieldValidation (在查询中): 字符串

    fieldValidation

  • force (在查询中): 布尔值

    force

  • pretty (在查询中): 字符串

    pretty

响应

200 (CSIStorageCapacity): 正常

201 (CSIStorageCapacity): 已创建

401: 未授权

delete 删除 CSIStorageCapacity

HTTP 请求

DELETE /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name}

参数

响应

200 (Status): 正常

202 (Status): 已接受

401: 未授权

deletecollection 删除 CSIStorageCapacity 的集合

HTTP 请求

DELETE /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities

参数

响应

200 (Status): 正常

401: 未授权

此页面是自动生成的。

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

上次修改时间：2024年8月28日下午6:01（太平洋标准时间）：更新 v1.31 的自动生成的 API 参考 (8ba98c79c1)