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)