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 表示应附加的卷。目前，只有 PersistenVolumes 可以通过外部附加程序附加，将来我们可能还允许 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.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.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 (in path): string, required

    VolumeAttachment 的名称

  • pretty (in query): string

    pretty

响应

200 (VolumeAttachment): OK

401: 未授权

get 读取指定 VolumeAttachment 的状态

HTTP 请求

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

参数

  • name (in path): string, required

    VolumeAttachment 的名称

  • pretty (in query): 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): 已创建

202 (VolumeAttachment): 已接受

401: 未授权

update 替换指定的 VolumeAttachment

HTTP 请求

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

参数

响应

200 (VolumeAttachment): OK

201 (VolumeAttachment): 已创建

401: 未授权

update 替换指定 VolumeAttachment 的状态

HTTP 请求

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

参数

响应

200 (VolumeAttachment): OK

201 (VolumeAttachment): 已创建

401: 未授权

patch 部分更新指定的 VolumeAttachment

HTTP 请求

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

参数

  • name (in path): string, required

    VolumeAttachment 的名称

  • body: Patch, required

  • dryRun (in query): string

    dryRun

  • fieldManager (in query): string

    fieldManager

  • fieldValidation (in query): string

    fieldValidation

  • force (in query): boolean

    force

  • pretty (in query): string

    pretty

响应

200 (VolumeAttachment): OK

201 (VolumeAttachment): 已创建

401: 未授权

patch 部分更新指定 VolumeAttachment 的状态

HTTP 请求

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

参数

  • name (in path): string, required

    VolumeAttachment 的名称

  • body: Patch, required

  • dryRun (in query): string

    dryRun

  • fieldManager (in query): string

    fieldManager

  • fieldValidation (in query): string

    fieldValidation

  • force (in query): boolean

    force

  • pretty (in query): string

    pretty

响应

200 (VolumeAttachment): OK

201 (VolumeAttachment): 已创建

401: 未授权

delete 删除 VolumeAttachment

HTTP 请求

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

参数

响应

200 (VolumeAttachment): OK

202 (VolumeAttachment): 已接受

401: 未授权

deletecollection 删除 VolumeAttachment 的集合

HTTP 请求

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

参数

响应

200 (Status): OK

401: 未授权

此页面是自动生成的。

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

上次修改于 2023 年 12 月 25 日美国太平洋时间上午 8:23：代码审查反馈 (55cfdc24fb)