Dokumentation Experience Platform Anleitung zu Katalog und Datensätzen

Löschen eines Objekts in der API

31. Dezember 2024

Themen:
Katalog

Erstellt für:

Entwickler

Sie können ein Catalog-Objekt löschen, indem Sie seine ID im Pfad einer DELETE-Anfrage angeben.

WARNING

Seien Sie beim Löschen von Objekten besonders vorsichtig, da dies nicht rückgängig gemacht werden kann und an anderer Stelle in Experience Platform zu grundlegenden Änderungen führen kann.

API-Format

DELETE /{OBJECT_TYPE}/{OBJECT_ID}

IMPORTANT

Der DELETE /batches/{ID}-Endpunkt wird nicht mehr unterstützt. Um einen Batch zu löschen, sollten Sie die Batch-Aufnahme-API“.

Parameter

Beschreibung

{OBJECT_TYPE}

Der Typ Catalog zu löschenden Objekts. Gültige Objekte sind:

dataSets
dataSetFiles

{OBJECT_ID}

Die Kennung des spezifischen Objekts, das Sie aktualisieren möchten.

Anfrage

Mit der folgenden Anfrage wird ein Datensatz gelöscht, dessen ID im Anfragepfad angegeben ist.

curl -X DELETE \
  'https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Antwort

Eine erfolgreiche Antwort gibt HTTP-Status 200 (OK) und ein Array mit der ID des gelöschten Datensatzes zurück. Diese ID sollte mit der in der DELETE-Anfrage gesendeten ID übereinstimmen. Wenn Sie eine GET-Anfrage für das gelöschte Objekt ausführen, wird der HTTP-Status 404 (Nicht gefunden) zurückgegeben. Damit wird bestätigt, dass der Datensatz erfolgreich gelöscht wurde.

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]

NOTE

Wenn keine Catalog Objekte mit der in Ihrer Anfrage angegebenen ID übereinstimmen, erhalten Sie möglicherweise trotzdem den HTTP-Status-Code 200, aber das Antwort-Array ist leer.

recommendation-more-help