StorageVersionMigration v1alpha1

StorageVersionMigration represents a migration of stored data to the latest storage version.

apiVersion: storagemigration.k8s.io/v1alpha1

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

StorageVersionMigration

StorageVersionMigration represents a migration of stored data to the latest storage version.

StorageVersionMigrationSpec

Spec of the storage version migration.

  • continueToken (string)

    The token used in the list options to get the next chunk of objects to migrate. When the .status.conditions indicates the migration is "Running", users can use this token to check the progress of the migration.

  • resource (GroupVersionResource), required

    The resource that is being migrated. The migrator sends requests to the endpoint serving the resource. Immutable.

    The names of the group, the version, and the resource.

    • resource.group (string)

      The name of the group.

    • resource.resource (string)

      The name of the resource.

    • resource.version (string)

      The name of the version.

StorageVersionMigrationStatus

Status of the storage version migration.

  • conditions ([]MigrationCondition)

    Patch strategy: merge on key type

    Map: unique values on key type will be kept during a merge

    The latest available observations of the migration's current state.

    Describes the state of a migration at a certain point.

    • conditions.status (string), required

      Status of the condition, one of True, False, Unknown.

    • conditions.type (string), required

      Type of the condition.

    • conditions.lastUpdateTime (Time)

      The last time this condition was updated.

      Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

    • conditions.message (string)

      A human readable message indicating details about the transition.

    • conditions.reason (string)

      The reason for the condition's last transition.

  • resourceVersion (string)

    ResourceVersion to compare with the GC cache for performing the migration. This is the current resource version of given group, version and resource when kube-controller-manager first observes this StorageVersionMigration resource.

StorageVersionMigrationList

StorageVersionMigrationList is a collection of storage version migrations.

© 2025 The Kubernetes Authors | Documentation Distributed under CC BY 4.0
Copyright © 2025 The Linux Foundation ®. All rights reserved.
https://kubernetes.io/docs/reference/kubernetes-api/config-and-storage-resources/storage-version-migration-v1alpha1/