StorageClass

StorageClass описывает параметры класса хранилища, для которого можно динамически выделять PersistentVolumes.

StorageClasses не привязаны к пространствам имён; имя класса хранилища согласно etcd указано в ObjectMeta.Name.

Документация по концепции StorageClass

Классы хранилищ

apiVersion: storage.k8s.io/v1

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

StorageClass

StorageClass описывает параметры класса хранилища, для которого можно динамически выделять PersistentVolumes.

StorageClasses не привязаны к пространствам имён; имя класса хранилища согласно etcd указано в ObjectMeta.Name.

Поле	Описание
`allowVolumeExpansion` boolean	allowVolumeExpansion указывает, допускает ли класс хранилища расширение тома.
`allowedTopologies` TopologySelectorTerm array	allowedTopologies ограничивает топологии узлов, в которых можно динамически выделять тома. Каждый плагин томов определяет собственные поддерживаемые спецификации топологии. Пустой список TopologySelectorTerm означает, что ограничений по топологии нет. Это поле учитывается только серверами, в которых включена функция VolumeScheduling.
`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
`mountOptions` string array	mountOptions задаёт параметры монтирования для динамически выделяемых PersistentVolumes этого класса хранилища, например ["ro", "soft"]. Проверка не выполняется — монтирование PV просто завершится с ошибкой, если один из параметров недопустим.
`parameters` object	parameters содержит параметры провижионера, который должен создавать тома этого класса хранилища.
`provisioner` * string	provisioner указывает тип провижионера.
`reclaimPolicy` string	reclaimPolicy задаёт политику возврата для динамически выделяемых PersistentVolumes этого класса хранилища. По умолчанию используется Delete. Возможные значения перечисления: - `"Delete"` означает, что после освобождения тома от привязки он будет удалён из Kubernetes. Плагин томов должен поддерживать удаление. - `"Recycle"` означает, что после освобождения тома от привязки он будет возвращён в пул непривязанных постоянных томов. Плагин томов должен поддерживать переработку. - `"Retain"` означает, что том останется в текущей фазе (Released) для последующего ручного возврата администратором. Политика по умолчанию — Retain.
`volumeBindingMode` string	volumeBindingMode указывает, как следует выделять и привязывать PersistentVolumeClaims. Если значение не задано, используется VolumeBindingImmediate. Это поле учитывается только серверами, в которых включена функция VolumeScheduling. Возможные значения перечисления: - `"Immediate"` указывает, что PersistentVolumeClaims следует сразу выделять и привязывать. Это режим по умолчанию. - `"WaitForFirstConsumer"` указывает, что PersistentVolumeClaims не следует выделять и привязывать до создания первого Pod, который ссылается на PeristentVolumeClaim. Выделение и привязка тома будут выполняться во время планирования Pod.

StorageClassList

StorageClassList — это коллекция классов хранилищ.

Поле	Описание
`apiVersion` string	APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознанные схемы в последнее внутреннее значение и могут отклонять нераспознанные значения. Дополнительные сведения: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`items` * StorageClass array	items — это список StorageClasses
`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

TopologySelectorLabelRequirement

Требование селектора топологии — это селектор, соответствующий заданной метке. Эта функция находится на альфа-стадии и может измениться в будущем.

Поле	Описание
`key` * string	Ключ метки, к которой применяется селектор.
`values` * string array	Массив строковых значений. Для выбора метки должно совпасть одно из значений. Элементы Values объединяются оператором ИЛИ.

TopologySelectorTerm

Элемент селектора топологии представляет результат запросов по меткам. Пустой элемент селектора топологии или значение null не соответствует ни одному объекту. Требования объединяются оператором И. Он предоставляет часть функциональности NodeSelectorTerm. Эта функция находится на альфа-стадии и может измениться в будущем.

Поле	Описание
`matchLabelExpressions` TopologySelectorLabelRequirement array	Список требований селектора топологии по меткам.

© 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/storage-class-v1/