StorageVersion

Версия хранилища для определённого ресурса.

apiVersion: internal.apiserver.k8s.io/v1alpha1

import "k8s.io/api/apiserverinternal/v1alpha1"

StorageVersion

Версия хранилища для определённого ресурса.

Поле	Описание
`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	metadata — стандартные метаданные объекта. Имя имеет формат \.\.
`spec` StorageVersionSpec	spec — пустая спецификация. Она присутствует для соответствия стилю API Kubernetes.
`status` StorageVersionStatus	status содержит сведения о версии, которую экземпляр API-сервера может декодировать и в которую может кодировать объекты при сохранении объектов во внутреннем хранилище.

StorageVersionSpec

StorageVersionSpec — пустая спецификация.

StorageVersionStatus

Экземпляры API-сервера сообщают версии, которые они могут декодировать, и версию, в которую они кодируют объекты при сохранении объектов во внутреннем хранилище.

Поле	Описание
`commonEncodingVersion` string	commonEncodingVersion задаётся как версия кодирования хранилища, если все экземпляры API-сервера используют одну и ту же версию. Если у них нет общей версии хранилища, это поле остаётся пустым. API-серверы должны завершить обновление записи storageVersionStatus до обработки операций записи, чтобы значение этого поля соответствовало фактическому состоянию.
`conditions` StorageVersionCondition array	conditions содержит последние доступные сведения о состоянии storageVersion.
`storageVersions` ServerStorageVersion array	storageVersions содержит сведения о версиях, сообщённые каждым экземпляром API-сервера.

StorageVersionList

Список объектов StorageVersion.

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

ServerStorageVersion

Экземпляр API-сервера сообщает версию, которую он может декодировать, и версию, в которую он кодирует объекты при сохранении объектов во внутреннем хранилище.

Поле	Описание
`apiServerID` * string	apiServerID — идентификатор API-сервера, отправившего сведения.
`decodableVersions` * string array	decodableVersions — это версии кодирования, которые API-сервер может обрабатывать при декодировании. API-сервер может декодировать объекты, закодированные в этих версиях. encodingVersion должна входить в decodableVersions.
`encodingVersion` * string	encodingVersion — версия, в которую API-сервер кодирует объект при его сохранении во внутреннем хранилище (например, etcd).
`servedVersions` string array	servedVersions содержит список всех версий, которые может предоставлять API-сервер. DecodableVersions должна включать все ServedVersions.

StorageVersionCondition

Описывает состояние storageVersion в определённый момент времени.

Поле	Описание
`lastTransitionTime` Time	lastTransitionTime — время последнего перехода условия из одного состояния в другое.
`message` * string	message — понятное человеку описание подробностей перехода.
`observedGeneration` integer	observedGeneration содержит значение .metadata.generation, на основании которого было установлено условие, если это поле задано.
`reason` * string	reason — причина последнего перехода условия.
`status` * string	status — состояние условия: True, False или Unknown.
`type` * string	type — тип условия.

© 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/apiserverinternal/storage-version-v1alpha1/