Skip to main content
Version: 3.6

VolumeSnapshotSchedule CRD reference

VolumeSnapshotSchedule represents a scheduled VolumeSnapshot object.

Starting with Stork 26.4.0, VolumeSnapshotSchedules for PVCs provisioned by the Portworx CSI driver (pxd.portworx.com) automatically use CSI VolumeSnapshots. See Associate a schedule policy using a CSI VolumeSnapshotClass for configuration details.

VolumeSnapshotSchedule

FieldDescriptionType
apiVersionAPIVersion defines the versioned schema of this representation of an object.
Servers should convert recognized schemas to the latest internal value, and
may reject unrecognized values.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
string
kindKind is a string value representing the REST resource this object represents.
Servers may infer this from the endpoint the client submits requests to.
Cannot be updated.
In CamelCase.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
string
specVolumeSnapshotScheduleSpec is the spec used to schedule volumesnapshotsobject
statusVolumeSnapshotScheduleStatus is the status of a volumesnapshot scheduleobject

metadata.annotations fields

AnnotationDescription
stork.libopenstorage.org/volume-snapshot-class-nameName of an existing VolumeSnapshotClass to use for CSI snapshots (Stork 26.4.0 and later). When set, Stork uses this class as-is for all CSI VolumeSnapshots created by this schedule. When absent, Stork auto-creates a VolumeSnapshotClass from the portworx/snapshot-type and portworx/cloud-cred-id annotations.
portworx/snapshot-typeSnapshot type: cloud for cloud backups, local for in-cluster snapshots. Used to auto-create the VolumeSnapshotClass when volume-snapshot-class-name is not set.
portworx/cloud-cred-idUUID of the Portworx cloud credential. Used to auto-create the VolumeSnapshotClass when volume-snapshot-class-name is not set. Required only when multiple cloud credentials are configured.
stork.libopenstorage.org/snapshot-restore-namespacesComma-separated list of namespaces to which snapshots created by this schedule can be restored.
openstorage.io/auth-secret-namespaceNamespace of the Kubernetes Secret holding the auth token. Required when PX-Security is enabled.
openstorage.io/auth-secret-nameName of the Kubernetes Secret holding the auth token. Required when PX-Security is enabled.

spec fields

FieldDescriptionType
spec.postExecRulePostExecRule is the name of the rule that will be executed after taking a snapshot.string
spec.preExecRulePreExecRule is the name of the rule that will be executed before taking a snapshot.string
spec.reclaimPolicyReclaimPolicy determines what happens to the snapshots when the VolumeSnapshotSchedule is deleted.string
spec.schedulePolicyNameSchedulePolicyName is the name of the schedule policy that determines when snapshots are taken.string
spec.suspendSuspend, if set to true, suspends the snapshot scheduleboolean
spec.templateTemplate specifies the configuration of the volume snapshot that will be created.object
spec.template.specVolumeSnapshotSpec is the desired state of the volume snapshotobject
spec.template.spec.persistentVolumeClaimNamePersistentVolumeClaimName is the name of the PVC being snapshottedstring
spec.template.spec.snapshotDataNameSnapshotDataName binds the VolumeSnapshot object with the VolumeSnapshotDatastring
In this topic: