VolumeAttachment

VolumeAttachment 捕獲了將指定卷附加到/從指定節點分離的意圖。

apiVersion: storage.k8s.io/v1

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

VolumeAttachment

VolumeAttachment 捕獲了將指定卷附加到/從指定節點分離的意圖。

VolumeAttachment 物件不是名稱空間的。

VolumeAttachmentSpec

VolumeAttachmentSpec 是 VolumeAttachment 請求的規範。

  • attacher (string), required

    attacher 指示必須處理此請求的卷驅動程式的名稱。這是 GetPluginName() 返回的名稱。

  • nodeName (string), required

    nodeName 表示應將卷附加到的節點。

  • source (VolumeAttachmentSource), required

    source 表示應附加的卷。

    VolumeAttachmentSource 表示應附加的卷。目前只有 PersistentVolumes 可以透過外部附加器附加，未來我們可能也允許 Pod 中的內聯卷。只能設定一個成員。

    • source.inlineVolumeSpec (PersistentVolumeSpec)

      inlineVolumeSpec 包含附加由 Pod 的內聯 VolumeSource 定義的持久卷所需的所有資訊。此欄位僅為 CSIMigration 功能填充。它包含從 Pod 的內聯 VolumeSource 到 PersistentVolumeSpec 的轉換欄位。此欄位為 Beta 版，僅被啟用了 CSIMigration 功能的伺服器支援。

    • source.persistentVolumeName (string)

      persistentVolumeName 表示要附加的持久卷的名稱。

VolumeAttachmentStatus

VolumeAttachmentStatus 是 VolumeAttachment 請求的狀態。

  • attached (boolean), required

    attached 指示卷已成功附加。此欄位只能由完成附加操作的實體（即外部附加器）設定。

  • attachError (VolumeError)

    attachError 表示附加操作期間遇到的最後一次錯誤（如果存在）。此欄位只能由完成附加操作的實體（即外部附加器）設定。

    VolumeError 捕獲了卷操作期間遇到的錯誤。

    • attachError.errorCode (int32)

      errorCode 是一個數字 gRPC 程式碼，表示在附加或分離操作期間遇到的錯誤。

      這是一個可選的 Beta 欄位，需要啟用 MutableCSINodeAllocatableCount 功能門才能設定。

    • attachError.message (string)

      message 表示在附加或分離操作期間遇到的錯誤。此字串可能會被記錄，因此不應包含敏感資訊。

    • attachError.time (Time)

      time 表示遇到錯誤的時間。

      Time 是 time.Time 的一個包裝器，支援正確地編組到 YAML 和 JSON。提供了 time 包提供的許多工廠方法的包裝器。

  • attachmentMetadata (map[string]string)

    attachmentMetadata 填充了附加操作成功後返回的任何資訊，這些資訊必須傳遞到後續的 WaitForAttach 或 Mount 呼叫中。此欄位只能由完成附加操作的實體（即外部附加器）設定。

  • detachError (VolumeError)

    detachError 表示分離操作期間遇到的最後一次錯誤（如果存在）。此欄位只能由完成分離操作的實體（即外部分離器）設定。

    VolumeError 捕獲了卷操作期間遇到的錯誤。

    • detachError.errorCode (int32)

      errorCode 是一個數字 gRPC 程式碼，表示在附加或分離操作期間遇到的錯誤。

      這是一個可選的 Beta 欄位，需要啟用 MutableCSINodeAllocatableCount 功能門才能設定。

    • detachError.message (string)

      message 表示在附加或分離操作期間遇到的錯誤。此字串可能會被記錄，因此不應包含敏感資訊。

    • detachError.time (Time)

      time 表示遇到錯誤的時間。

      Time 是 time.Time 的一個包裝器，支援正確地編組到 YAML 和 JSON。提供了 time 包提供的許多工廠方法的包裝器。

VolumeAttachmentList

VolumeAttachmentList 是 VolumeAttachment 物件的集合。

操作

get 讀取指定的 VolumeAttachment

HTTP 請求

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

引數

  • name (在路徑中): string，必填

    VolumeAttachment 的名稱

  • pretty (在查詢中): string

    pretty

響應

200 (VolumeAttachment): OK

401: 未授權

get 讀取指定 VolumeAttachment 的狀態

HTTP 請求

GET /apis/storage.k8s.io/v1/volumeattachments/{name}/status

引數

  • name (在路徑中): string，必填

    VolumeAttachment 的名稱

  • pretty (在查詢中): string

    pretty

響應

200 (VolumeAttachment): OK

401: 未授權

list 列出或監視 VolumeAttachment 型別的物件

HTTP 請求

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

引數

響應

200 (VolumeAttachmentList): OK

401: 未授權

create 建立一個 VolumeAttachment

HTTP 請求

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

引數

響應

200 (VolumeAttachment): OK

201 (VolumeAttachment): Created

202 (VolumeAttachment): Accepted

401: 未授權

update 替換指定的 VolumeAttachment

HTTP 請求

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

引數

響應

200 (VolumeAttachment): OK

201 (VolumeAttachment): Created

401: 未授權

update 替換指定 VolumeAttachment 的狀態

HTTP 請求

PUT /apis/storage.k8s.io/v1/volumeattachments/{name}/status

引數

響應

200 (VolumeAttachment): OK

201 (VolumeAttachment): Created

401: 未授權

patch 部分更新指定的 VolumeAttachment

HTTP 請求

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

引數

  • name (在路徑中): string，必填

    VolumeAttachment 的名稱

  • body: Patch，必需

  • dryRun (在查詢中): string

    dryRun

  • fieldManager (在查詢中): string

    fieldManager

  • fieldValidation (在查詢中): string

    fieldValidation

  • force (在查詢中): boolean

    force

  • pretty (在查詢中): string

    pretty

響應

200 (VolumeAttachment): OK

201 (VolumeAttachment): Created

401: 未授權

patch 部分更新指定 VolumeAttachment 的狀態

HTTP 請求

PATCH /apis/storage.k8s.io/v1/volumeattachments/{name}/status

引數

  • name (在路徑中): string，必填

    VolumeAttachment 的名稱

  • body: Patch，必需

  • dryRun (在查詢中): string

    dryRun

  • fieldManager (在查詢中): string

    fieldManager

  • fieldValidation (在查詢中): string

    fieldValidation

  • force (在查詢中): boolean

    force

  • pretty (在查詢中): string

    pretty

響應

200 (VolumeAttachment): OK

201 (VolumeAttachment): Created

401: 未授權

delete 刪除一個 VolumeAttachment

HTTP 請求

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

引數

響應

200 (VolumeAttachment): OK

202 (VolumeAttachment): Accepted

401: 未授權

deletecollection 刪除 VolumeAttachment 集合

HTTP 請求

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

引數

響應

200 (Status): OK

401: 未授權

本頁面是自動生成的。

如果你打算報告此頁面存在的問題，請在問題描述中提及此頁面是自動生成的。修復可能需要在 Kubernetes 專案的其他地方進行。

上次修改時間：2025 年 9 月 4 日 下午 3:37 PST：更新 v1.34 的 API 資源參考 (3e10e8c195)