StorageClass

StorageClass 描述了可以动态配置 PersistentVolumes 的存储类的参数。

apiVersion: storage.k8s.io/v1

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

StorageClass

StorageClass 描述了可以动态配置 PersistentVolumes 的存储类的参数。

StorageClasses 是非命名空间的;etcd 中的存储类的名称在 ObjectMeta.Name 中。


  • apiVersion: storage.k8s.io/v1

  • kind: StorageClass

  • metadata (ObjectMeta)

    标准对象的元数据。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

  • provisioner (string), 必需

    provisioner 指示了 provisioner 的类型。

  • allowVolumeExpansion (boolean)

    allowVolumeExpansion 表明该存储类是否允许卷扩展。

  • allowedTopologies ([]TopologySelectorTerm)

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

    allowedTopologies 限制了卷可以动态配置的节点拓扑。每个卷插件都定义了自己的支持的拓扑规范。空 TopologySelectorTerm 列表表示没有拓扑限制。只有启用了 VolumeScheduling 功能的服务器才会考虑此字段。

    拓扑选择器术语表示标签查询的结果。空或 null 的拓扑选择器术语不匹配任何对象。它们之间的要求是 AND 关系。它提供了 NodeSelectorTerm 的一部分功能。这是一个 Alpha 功能,未来可能会有所更改。

    • allowedTopologies.matchLabelExpressions ([]TopologySelectorLabelRequirement)

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

      通过标签匹配的拓扑选择器要求列表。

      拓扑选择器要求是通过标签匹配的。这是一个 Alpha 功能,未来可能会有所更改。

      • allowedTopologies.matchLabelExpressions.key (string), 必需

        选择器适用的标签键。

      • allowedTopologies.matchLabelExpressions.values ([]string), 必需

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

        字符串值数组。必须有一个值与标签匹配才能被选中。Values 中的每个条目都是 OR 关系。

  • mountOptions ([]string)

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

    mountOptions 控制此存储类的动态配置的 PersistentVolumes 的挂载选项。例如:["ro", "soft"]。未经验证 - 如果有无效选项,PV 的挂载将简单地失败。

  • parameters (map[string]string)

    parameters 包含 provisioner 创建此类存储的卷的参数。

  • reclaimPolicy (string)

    reclaimPolicy 控制此存储类的动态配置的 PersistentVolumes 的回收策略。默认为 Delete。

  • volumeBindingMode (string)

    volumeBindingMode 指示 PersistentVolumeClaims 的配置和绑定方式。如果未设置,则使用 VolumeBindingImmediate。只有启用了 VolumeScheduling 功能的服务器才会考虑此字段。

StorageClassList

StorageClassList 是存储类的集合。


操作


get 读取指定的 StorageClass

HTTP 请求

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

参数

  • name (在路径中): string,必填

    StorageClass 的名称

  • pretty (在查询中): string

    pretty

响应

200 (StorageClass): OK

401: 未授权

list 列出或观察 StorageClass 类型的对象

HTTP 请求

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

参数

响应

200 (StorageClassList): OK

401: 未授权

create 创建一个 StorageClass

HTTP 请求

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

参数

响应

200 (StorageClass): OK

201 (StorageClass): Created

202 (StorageClass): Accepted

401: 未授权

update 替换指定的 StorageClass

HTTP 请求

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

参数

响应

200 (StorageClass): OK

201 (StorageClass): Created

401: 未授权

patch 部分更新指定的 StorageClass

HTTP 请求

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

参数

  • name (在路径中): string,必填

    StorageClass 的名称

  • body: Patch,必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (在查询中): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (StorageClass): OK

201 (StorageClass): Created

401: 未授权

delete 删除一个 StorageClass

HTTP 请求

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

参数

响应

200 (StorageClass): OK

202 (StorageClass): Accepted

401: 未授权

deletecollection 删除 StorageClass 的集合

HTTP 请求

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

参数

响应

200 (Status): OK

401: 未授权

本页面是自动生成的。

如果你打算报告此页面存在的问题,请在问题描述中提及此页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。

上次修改时间:2025 年 4 月 9 日太平洋标准时间下午 6:36:更新 v1.32 的 API 参考文档 (a3b579d035)