VolumeAttachment

VolumeAttachment 用于捕获将指定卷挂载到指定节点或从指定节点卸载该卷的意图。

apiVersion: storage.k8s.io/v1

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

VolumeAttachment

VolumeAttachment 用于捕获将指定卷挂载到指定节点或从指定节点卸载该卷的意图。

VolumeAttachment 对象不属于命名空间。


VolumeAttachmentSpec

VolumeAttachmentSpec 是 VolumeAttachment 请求的规范。


  • attacher (string),必需

    attacher 指示必须处理此请求的卷驱动程序的名称。这是 GetPluginName() 返回的名称。

  • nodeName (string),必需

    nodeName 表示应该将卷挂载到的节点。

  • source (VolumeAttachmentSource),必需

    source 表示应该挂载的卷。

    VolumeAttachmentSource 表示应该挂载的卷。目前只有 PersistentVolumes 可以通过外部挂载程序挂载,将来我们可能会允许 Pod 中的内联卷。只能设置一个成员。

    • source.inlineVolumeSpec (PersistentVolumeSpec)

      inlineVolumeSpec 包含挂载 Pod 内联 VolumeSource 定义的持久卷所需的所有信息。此字段仅针对 CSIMigration 功能填充。它包含从 Pod 的内联 VolumeSource 到 PersistentVolumeSpec 的转换后字段。此字段处于测试阶段,仅由启用了 CSIMigration 功能的服务器接受。

    • source.persistentVolumeName (string)

      persistentVolumeName 表示要挂载的持久卷的名称。

VolumeAttachmentStatus

VolumeAttachmentStatus 是 VolumeAttachment 请求的状态。


  • attached (boolean),必需

    attached 指示卷已成功挂载。此字段只能由完成挂载操作的实体(即 external-attacher)设置。

  • attachError (VolumeError)

    attachError 表示在挂载操作期间遇到的最后一个错误(如果有)。此字段只能由完成挂载操作的实体(即 external-attacher)设置。

    VolumeError 捕获卷操作期间遇到的错误。

    • attachError.errorCode (int32)

      errorCode 是一个数字 gRPC 代码,表示在挂载或卸载操作期间遇到的错误。

      这是一个可选的测试版字段,需要启用 MutableCSINodeAllocatableCount 功能开关才能设置。

    • attachError.message (string)

      message 表示在挂载或卸载操作期间遇到的错误。此字符串可能会被记录,因此不应包含敏感信息。

    • attachError.time (Time)

      time 表示遇到错误的时间。

      Time 是 time.Time 的包装器,支持正确地编组到 YAML 和 JSON。为时间包提供的许多工厂方法提供包装器。

  • attachmentMetadata (map[string]string)

    attachmentMetadata 在挂载成功后,使用挂载操作返回的任何信息进行填充,这些信息必须传递给后续的 WaitForAttach 或 Mount 调用。此字段只能由完成挂载操作的实体(即 external-attacher)设置。

  • detachError (VolumeError)

    detachError 表示在卸载操作期间遇到的最后一个错误(如果有)。此字段只能由完成卸载操作的实体(即 external-attacher)设置。

    VolumeError 捕获卷操作期间遇到的错误。

    • detachError.errorCode (int32)

      errorCode 是一个数字 gRPC 代码,表示在挂载或卸载操作期间遇到的错误。

      这是一个可选的测试版字段,需要启用 MutableCSINodeAllocatableCount 功能开关才能设置。

    • detachError.message (string)

      message 表示在挂载或卸载操作期间遇到的错误。此字符串可能会被记录,因此不应包含敏感信息。

    • detachError.time (Time)

      time 表示遇到错误的时间。

      Time 是 time.Time 的包装器,支持正确地编组到 YAML 和 JSON。为时间包提供的许多工厂方法提供包装器。

VolumeAttachmentList

VolumeAttachmentList 是 VolumeAttachment 对象的集合。


操作


get 读取指定的 VolumeAttachment

HTTP 请求

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

Parameters

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

    VolumeAttachment 的名称

  • pretty (在查询中): string

    pretty

响应

200 (VolumeAttachment): 成功

401: 未授权

get 读取指定的 VolumeAttachment 的状态

HTTP 请求

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

Parameters

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

    VolumeAttachment 的名称

  • pretty (在查询中): string

    pretty

响应

200 (VolumeAttachment): 成功

401: 未授权

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

HTTP 请求

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

Parameters

响应

200 (VolumeAttachmentList): 成功

401: 未授权

create 创建一个 VolumeAttachment

HTTP 请求

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

Parameters

响应

200 (VolumeAttachment): 成功

201 (VolumeAttachment): 已创建

202 (VolumeAttachment): 已接受

401: 未授权

update 替换指定的 VolumeAttachment

HTTP 请求

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

Parameters

响应

200 (VolumeAttachment): 成功

201 (VolumeAttachment): 已创建

401: 未授权

update 替换指定的 VolumeAttachment 的状态

HTTP 请求

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

Parameters

响应

200 (VolumeAttachment): 成功

201 (VolumeAttachment): 已创建

401: 未授权

patch 部分更新指定的 VolumeAttachment

HTTP 请求

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

Parameters

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

    VolumeAttachment 的名称

  • body: Patch, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (in query): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (VolumeAttachment): 成功

201 (VolumeAttachment): 已创建

401: 未授权

patch 部分更新指定的 VolumeAttachment 的状态

HTTP 请求

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

Parameters

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

    VolumeAttachment 的名称

  • body: Patch, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (in query): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (VolumeAttachment): 成功

201 (VolumeAttachment): 已创建

401: 未授权

delete 删除一个 VolumeAttachment

HTTP 请求

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

Parameters

响应

200 (VolumeAttachment): 成功

202 (VolumeAttachment): 已接受

401: 未授权

deletecollection 删除 VolumeAttachment 集合

HTTP 请求

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

Parameters

响应

200 (Status): 确定

401: 未授权


最后修改时间:2025 年 9 月 4 日下午 3:37 PST:更新 v1.34 的 API 资源参考 (3e10e8c195)

本页面是自动生成的。

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