Snapshots

Ein Snapshot ist eine wiederherstellbare Kopie eines Index, die Ihrer Organisation gehört — nicht das Engine-Backup des Betreibers (/admin/snapshot).

Inhalt: documents.ndjson.gz, schema.json, synonyms.json, curations.json, stemming.json, stopwords.json, rules.json, profiles.json und manifest.json (wird zuletzt geschrieben; ohne Manifest gilt ein Snapshot als unvollständig).

curl -sS -X POST "$AAC_API/indexes/products/snapshots" -H "Authorization: Bearer $AAC_KEY"

{
	"job_id": "clx9a4...",
	"snapshot_id": "snap_mh3k2a1b0f3c9e7d21a",
	"status": "queued",
	"pruned": [],
	"request_id": "req_..."
}

Antwort 202 mit einem snapshot-Job (GET /jobs/{jobId}). Benötigt settings:write und documents:write.

Am Limit: 409 SNAPSHOT_LIMIT_REACHED; ?prune=true löscht zuerst die ältesten. Der neueste Snapshot jedes Index bleibt immer erhalten.

GET /snapshots/{id} liefert das Manifest und einen Download-Link (content_encoding: "gzip", format: "ndjson"), 15 Minuten gültig; Lesen braucht documents:read.

POST /snapshots/{id}/restore → 202 { job_id, status }: neue Collection aus dem Snapshot, Ranking-Konfiguration wird eingespielt, Alias wird atomar umgeschrieben; die ersetzte Collection bleibt als Rollback erhalten. Bei aktivem Reindex oder Restore: 409 JOB_CONFLICT.

Fremde Snapshot-IDs sind 404 SNAPSHOT_NOT_FOUND. Dokumente werden als Stream exportiert und in begrenzten Paketen wiederhergestellt. Metadaten bleiben bis zum Abgleich im Speicher; der Bedarf wächst weiterhin mit der Datensatzanzahl.

Neue Snapshots enthalten maskierte Verweise auf Embedding-Zugangsdaten. Die Wiederherstellung verwendet den aktuellen Schlüssel desselben Anbieters und Endpunkts; historische Snapshot-Schlüssel werden nie wiederhergestellt. Ohne passende Verbindung endet der Auftrag vor der Umschaltung der laufenden Suche.

Vor der Veröffentlichung prüft die Wiederherstellung Prüfsummen und Größen aller Konfigurationsdateien und komprimierten Dokumente sowie die Datensatzanzahl. Änderungen an Schema, Anbieterschlüssel oder Einstellungen während des Ladens verhindern die veraltete Umschaltung; ein erneuter Versuch verwendet die aktuelle Konfiguration. Einschränkungen privater Felder aus aktuellen Einstellungen und Snapshot bleiben erhalten. Sie können danach separat in den Einstellungen gelockert werden.