StorageClass

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

apiVersion: storage.k8s.io/v1

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

StorageClass

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

StorageClass 是非命名空间的；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 功能的服务器使用。

    一个拓扑选择器项表示标签查询的结果。一个空或空的拓扑选择器项不匹配任何对象。它们的要求是 AND 的关系。它提供 NodeSelectorTerm 的一个子集功能。这是一个 alpha 功能，将来可能会发生变化。

    • allowedTopologies.matchLabelExpressions ([]TopologySelectorLabelRequirement)

      原子操作：在合并期间将被替换

      按标签列出的拓扑选择器需求列表。

      一个拓扑选择器需求是一个匹配给定标签的选择器。这是一个 alpha 功能，将来可能会发生变化。

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

        选择器应用到的标签键。

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

        原子操作：在合并期间将被替换

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

  • mountOptions ([]string)

    原子操作：在合并期间将被替换

    mountOptions 控制此存储类的动态配置的 PersistentVolume 的 mountOptions。例如：["ro", "soft"]。未验证 - 如果其中一个无效，则 PV 的挂载将直接失败。

  • parameters (map[string]string)

    parameters 保存应该创建此存储类的卷的 provisioner 的参数。

  • reclaimPolicy (string)

    reclaimPolicy 控制此存储类的动态配置的 PersistentVolume 的 reclaimPolicy。默认为 Delete。

  • volumeBindingMode (string)

    volumeBindingMode 指示应如何配置和绑定 PersistentVolumeClaim。如果未设置，则使用 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): 已创建

202 (StorageClass): 已接受

401: 未授权

update 替换指定的 StorageClass

HTTP 请求

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

参数

  • name (在路径中): string，必需

    StorageClass 的名称

  • body: StorageClass，必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • pretty (在查询中): string

    pretty

响应

200 (StorageClass): OK

201 (StorageClass): 已创建

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): 已创建

401: 未授权

delete 删除 StorageClass

HTTP 请求

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

参数

响应

200 (StorageClass): OK

202 (StorageClass): 已接受

401: 未授权

deletecollection 删除 StorageClass 的集合

HTTP 请求

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

参数

响应

200 (Status): OK

401: 未授权

此页面是自动生成的。

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

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