Löschen eines Objekts in der API

Sie können eine Catalog -Objekt, indem Sie die Kennung im Pfad einer DELETE-Anfrage angeben.

WARNUNG

Seien Sie besonders vorsichtig beim Löschen von Objekten, da dies nicht rückgängig gemacht werden kann und andernorts in Experience Platform.

API-Format

DELETE /{OBJECT_TYPE}/{OBJECT_ID}
WICHTIG

Die 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 von Catalog -Objekt, das gelöscht werden soll. Gültige Objekte sind:
  • accounts
  • connections
  • dataSets
  • dataSetFiles
  • dataSetViews
{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"
]
HINWEIS

Wenn nicht Catalog -Objekte mit der in Ihrer Anfrage angegebenen ID übereinstimmen, erhalten Sie möglicherweise weiterhin einen HTTP-Status-Code 200, das Antwort-Array ist jedoch leer.

Auf dieser Seite