Taskstream-Historie und Aufbewahrung verwalten
Diese Referenz erklärt, wie Workspace Taskstream-Ausführungsnachweise begrenzt, aufbewahrt und durch einen Legal Hold schützt. Nutzen Sie die Seite als Administrator, wenn Sie Job-Historie prüfen, einen Nachweis sperren oder die sichere Löschbarkeit eines Jobs beurteilen müssen.
Taskstream bleibt im eingeschränkten Sicherheitsbetrieb. Verwenden Sie die History- und Retention-Aktionen nur über den freigegebenen Trusted-Operator-Zugang. Im Standardbetrieb bleiben externe mutierende Taskstream-Routen geschlossen.
Welche Nachweise Workspace speichert
Neue öffentliche Job-Logs enthalten eine stabile Ergebnisklasse und, falls vorhanden, die zugehörige Occurrence- und Attempt-ID. Workspace begrenzt das Resultat auf 64 KiB. Freie Fehlermeldungen, Credential-Werte, SQL-Details, Dateipfade sowie DNS-, TLS- oder Runtime-Fehler erscheinen nicht in der öffentlichen Historie.
Workspace kennzeichnet abgeschnittene Resultate und Fehlerquellen getrennt. Ältere Logs ohne belegte Sanitization-Version bleiben aus der neuen öffentlichen History ausgeblendet. Workspace ergänzt diese Evidence nicht nachträglich.
Fristen
| Nachweis | Feste V1-Frist |
|---|---|
| Job-Logs | 30 Tage nach Abschluss des Logeintrags |
| Terminale Attempts | 365 Tage nach ihrem Abschluss |
| Terminale Occurrences | 365 Tage nach ihrem Abschluss |
| Nicht mehr referenzierte Autorisierungsnachweise | 365 Tage nach Widerruf, Ablauf oder Erstellung |
| Jobdefinitionen und technische Controls | Keine automatische Löschung |
Ein tenantgebundener Wartungsjob entfernt abgelaufene, nicht geschützte Nachweise in kleinen Batches. Archivierung verkürzt keine Frist. Sie bleibt der normale Weg, abgeschlossene Jobs aus der aktiven Liste zu nehmen.
Historie lesen
GET /api/v1/jobs/{jobId}/logs unterstützt einen opaken Keyset-Cursor. Nutzen Sie cursor für neue Integrationen. Das Standardlimit beträgt 25, das Maximum
- Die Response liefert den nächsten Cursor unter
meta.cursorPagination.nextCursor. Ein Cursor ändert weder den Tenant noch die Job-ID.
Bestehende Clients können page und count oder offset und limit weiterverwenden. Auch dieser Pfad liefert höchstens 200 Einträge pro Request.
Legal Hold setzen und freigeben
Ein Legal Hold schützt die Jobdefinition, technische Controls, Logs, Occurrences, Attempts und referenzierte Autorisierungsnachweise. Verwenden Sie dafür ausschließlich eine Identität mit taskstream:jobs:retention.
| Aktion | Endpoint | Pflichtfeld |
|---|---|---|
| Hold setzen | POST /api/v1/jobs/{jobId}/retention-hold | reason |
| Hold freigeben | POST /api/v1/jobs/{jobId}/retention-release | reason |
Der Grund muss nach Normalisierung zwischen 1 und 512 Byte lang sein. Schreiben Sie eine fachlich nachvollziehbare Begründung, aber keine Passwörter, Tokens oder anderen Credential-Werte hinein. Workspace speichert Actor, Zeitpunkt und Audit-Korrelation. Eine Freigabe ergänzt eigene Release-Evidence und verändert den ursprünglichen Hold-Grund nicht.
Pro Job kann nur ein Hold aktiv sein. Eine Freigabe ohne aktiven Hold und ein zweiter paralleler Hold enden mit einem stabilen Konflikt.
Löschung beurteilen
Workspace blockiert einen Log-Reset bei aktivem Hold. Die Joblöschung ist zusätzlich gesperrt, solange eine Occurrence nicht terminal, ein Attempt aktiv oder ein Autorisierungsnachweis weiterhin referenziert ist.
Prüfen Sie vor einer Löschung:
- Archivieren Sie den Job, wenn Sie ihn nur aus der aktiven Liste entfernen möchten.
- Prüfen Sie, ob ein Legal Hold aktiv ist.
- Prüfen Sie laufende oder wartende Ausführungen.
- Geben Sie einen Hold nur mit fachlicher Freigabe und dokumentiertem Grund frei.
- Löschen Sie den Job erst, wenn Workspace keine Retention-Sperre mehr meldet.
TASKSTREAM_RETENTION_BLOCKED bedeutet, dass Evidence weiterhin geschützt oder referenziert ist. TASKSTREAM_RETENTION_UNAVAILABLE bedeutet, dass Workspace den Schutzvertrag nicht sicher lesen konnte. Wiederholen Sie in diesem Fall keine Löschung über direkte Datenbankzugriffe.
Erfolg prüfen
Die Prüfung ist abgeschlossen, wenn die History nur stabile, begrenzte Einträge liefert, der Hold mit Actor und Grund bestätigt ist und Reset oder Delete während des Holds mit einem Retention-Konflikt endet. Nach einer freigegebenen Release-Aktion bleibt der abgeschlossene Hold als Auditnachweis erhalten.
Diese Funktion ersetzt keine rechtliche Bewertung Ihrer Aufbewahrungs- oder Löschpflichten.