Löschen eines Objekts in der API

Sie können ein Catalog-Objekt löschen, indem Sie dessen 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 zu unerwarteten Änderungen führen kann.

API-Format

DELETE /{OBJECT_TYPE}/{OBJECT_ID}
WICHTIG

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

Parameter Beschreibung
{OBJECT_TYPE} Der Typ des zu löschenden Catalog -Objekts. 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: {IMS_ORG}' \
  -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 keine 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