Datasets
Retention-Flag setzen
Dataset für langfristige Aufbewahrung markieren oder Flag löschen.
PUT
Retention-Flag setzen
PUT https://api-datahub.octoparse.com/v1/datasets/{dataset_id}/retention
Authentifizierung: API-Schlüssel erforderlich (Authorization: Bearer <API Key>).
Run-Ergebnisse standardmäßig 90 Tage ab Erstellung. Datasets mit Retention-Flag aus Expiry-Cleanup ausgenommen. Flag = explizite User-Erklärung: Lesen erneuert nicht; Set/Clear sind idempotent.
Nur eigene Datasets markieren. Dataset anderer, öffentliches Seed-Dataset oder fehlende ID → 404. Das Mark-Gate ist enger als Visibility, weil Seed-Datasets nicht Ihr Output sind und nicht bereinigt werden — Markieren ist sinnlos.
Anfrage
Pfadparameter
string
erforderlich
Dataset-ID.
Anfrage-Body
boolean
erforderlich
true zum Behalten, false zum Löschen des Flags.Beispielanfrage
Antwort
200 Erfolg
Fehler
Fehlerantworten nutzen
{"error": {code, category, message, retryable}}. Siehe Fehler.