VolumeAttachment

VolumeAttachment описывает намерение подключить указанный том к указанному узлу или отключить его от этого узла.

Объекты VolumeAttachment не принадлежат пространствам имён.

apiVersion: storage.k8s.io/v1

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

VolumeAttachment

VolumeAttachment описывает намерение подключить указанный том к указанному узлу или отключить его от этого узла.

Объекты VolumeAttachment не принадлежат пространствам имён.

Поле	Описание
`apiVersion` string	APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознанные схемы в последнее внутреннее представление и могут отклонять нераспознанные значения. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind` string	Kind — строковое значение, представляющее ресурс REST, который описывает этот объект. Серверы могут определить его по конечной точке, на которую клиент отправляет запросы. Не может быть изменено. В CamelCase. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata` ObjectMeta	Стандартные метаданные объекта. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`spec` * VolumeAttachmentSpec	spec описывает желаемое поведение при подключении или отключении тома. Заполняется системой Kubernetes.
`status` VolumeAttachmentStatus	status описывает состояние запроса VolumeAttachment. Заполняется сущностью, выполняющей операцию подключения или отключения, то есть внешним подключающим модулем.

VolumeAttachmentSpec

VolumeAttachmentSpec — спецификация запроса VolumeAttachment.

Поле	Описание
`attacher` * string	attacher указывает имя драйвера тома, который ДОЛЖЕН обработать этот запрос. Это имя, возвращаемое методом GetPluginName().
`nodeName` * string	nodeName обозначает узел, к которому следует подключить том.
`source` * VolumeAttachmentSource	source обозначает том, который следует подключить.

VolumeAttachmentStatus

VolumeAttachmentStatus — состояние запроса VolumeAttachment.

Поле	Описание
`attachError` VolumeError	attachError описывает последнюю ошибку, возникшую во время операции подключения, если таковая была. Это поле может задавать только сущность, выполняющая операцию подключения, то есть внешний подключающий модуль.
`attached` * boolean	attached указывает, что том успешно подключён. Это поле может задавать только сущность, выполняющая операцию подключения, то есть внешний подключающий модуль.
`attachmentMetadata` object	attachmentMetadata заполняется информацией, возвращённой операцией подключения после её успешного завершения. Эта информация должна передаваться последующим вызовам WaitForAttach или Mount. Это поле может задавать только сущность, выполняющая операцию подключения, то есть внешний подключающий модуль.
`detachError` VolumeError	detachError описывает последнюю ошибку, возникшую во время операции отключения, если таковая была. Это поле может задавать только сущность, выполняющая операцию отключения, то есть внешний подключающий модуль.

VolumeAttachmentList

VolumeAttachmentList — коллекция объектов VolumeAttachment.

Поле	Описание
`apiVersion` string	APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознанные схемы в последнее внутреннее представление и могут отклонять нераспознанные значения. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`items` * Массив VolumeAttachment	items — список объектов VolumeAttachment
`kind` string	Kind — строковое значение, представляющее ресурс REST, который описывает этот объект. Серверы могут определить его по конечной точке, на которую клиент отправляет запросы. Не может быть изменено. В CamelCase. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata` ListMeta	Стандартные метаданные списка. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

VolumeAttachmentSource

VolumeAttachmentSource представляет том, который следует подключить. В настоящее время через внешний подключающий модуль можно подключать только PersistentVolumes; в будущем мы, возможно, разрешим также встраиваемые тома в подах. Можно задать ровно одно поле.

Поле Описание

inlineVolumeSpec
PersistentVolumeSpec inlineVolumeSpec содержит всю информацию, необходимую для подключения постоянного тома, заданного через встроенный VolumeSource пода. Это поле заполняется только для функции CSIMigration. Оно содержит поля, преобразованные из встроенного VolumeSource пода в PersistentVolumeSpec. Это поле имеет уровень бета-версии и учитывается только серверами, на которых включена функция CSIMigration.

persistentVolumeName
string persistentVolumeName обозначает имя постоянного тома, который нужно подключить.

Поле	Описание
`inlineVolumeSpec` PersistentVolumeSpec	inlineVolumeSpec содержит всю информацию, необходимую для подключения постоянного тома, заданного через встроенный VolumeSource пода. Это поле заполняется только для функции CSIMigration. Оно содержит поля, преобразованные из встроенного VolumeSource пода в PersistentVolumeSpec. Это поле имеет уровень бета-версии и учитывается только серверами, на которых включена функция CSIMigration.
`persistentVolumeName` string	persistentVolumeName обозначает имя постоянного тома, который нужно подключить.

VolumeError

VolumeError описывает ошибку, возникшую во время операции с томом.

Поле	Описание
`errorCode` integer	errorCode — числовой код gRPC, обозначающий ошибку, возникшую во время операции Attach или Detach. Для задания этого поля необходимо включить функциональный переключатель MutableCSINodeAllocatableCount.
`message` string	message описывает ошибку, возникшую во время операции Attach или Detach. Эта строка может попасть в журнал, поэтому она не должна содержать конфиденциальную информацию.
`time` Time	time обозначает время возникновения ошибки.

© 2026 The Kubernetes Authors | Documentation Distributed under CC BY 4.0
Copyright © 2026 The Linux Foundation ®. All rights reserved.
https://kubernetes.io/docs/reference/kubernetes-api/storage/volume-attachment-v1/