Sie können eine Catalog -Objekt, indem Sie die Kennung im Pfad einer DELETE-Anfrage angeben.
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}
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:
|
{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"
]
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.