Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

QdrantRestore

qdrantrestores.qdrant.io, short name qr, namespaced. Recovery of a backup into a cluster. The spec is immutable.

Spec

FieldDefaultDescription
backupRef.nameA Completed QdrantBackup. Exclusive with source
backupRef.namespaceown namespace
source.s3.bucketDirect bucket source. Exclusive with backupRef
source.s3.pathKey prefix that holds manifest.json
source.s3.region, endpoint, forcePathStyle, credentialsSecretRefas on QdrantBackupCredentials from the restore's namespace
targetClusterRef.namerequiredCluster to restore into; node count must equal the manifest's
targetClusterRef.namespaceown namespace
collections[]all in the manifestSubset to restore
collectionMapping{}Source name to target name
prioritysnapshotsnapshot, replica or no_sync
waitForIndexingtruePoll until the collection is green, up to one hour

Admission rules: exactly one of backupRef and source; the spec cannot change.

Status

FieldMeaning
phasePending, Downloading, Restoring, Completed or Failed
startTime, completionTime
sourceBackupThe backup name, or the s3:// URI of the source
restoredCollections[]Per collection: name, originalName when remapped, status, size, pointsCount, error
progresscollectionsTotal, collectionsCompleted, currentCollection, percentage
errorThe first failed collection's error
conditions[Complete]RestoreCompleted or RestoreFailed, message Restored n/m

Behavior

On create only. Resolves the source, retrying every thirty seconds while the backup is not Completed or a Secret is missing, reads the manifest, fails when the node counts differ, then for each selected collection hands every target node a presigned URL, valid one hour, for the snapshot of the source node with the same ordinal via PUT /collections/<target>/snapshots/recover?wait=true, and waits for green when asked to. Completed, or Failed when any collection failed.

Print columns: SOURCE, TARGET, PHASE, AGE.