// Module included in the following assemblies:
//
// * microshift_storage/microshift-storage-migration.adoc

:_mod-docs-content-type: PROCEDURE
[id="microshift-making-storage-migration-request_{context}"]
= Making a storage migration request

Storage migration is the process of updating stored data to the latest storage version, for example from `v1beta1` to `v1beta2`. To update your storage version, use the following procedure.

.Procedure

* Either you or any controller that has support for the `StorageVersionMigration` API must trigger a migration request. Use the following example request for reference:
+
.Example request
+
[source,terminal]
----
apiVersion: migration.k8s.io/v1alpha1
kind: StorageVersionMigration
metadata:
  name: snapshot-v1
spec:
  resource:
    group: snapshot.storage.k8s.io
    resource: volumesnapshotclasses <1>
    version: v1 <2>
----
<1> You must use the plural name of the resource.
<2> Version being updated to.

*  The progress of the migration is posted to the `StorageVersionMigration` status.

[NOTE]
====
* Failures can occur because of a misnamed group or resource.
* Migration failures can also occur when there is an incompatibility between the previous and latest versions.
====