DocumentazioneExperience PlatformGuida al catalogo e ai set di dati

Eliminare un oggetto nell’API

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Sviluppatore

È possibile eliminare un oggetto Catalog fornendo il relativo ID nel percorso di una richiesta DELETE.

WARNING
Prestare particolare attenzione durante l'eliminazione degli oggetti, poiché questa operazione non può essere annullata e può causare modifiche che causano interruzioni in altre aree di Experience Platform.

Formato API

DELETE /{OBJECT_TYPE}/{OBJECT_ID}
IMPORTANT
L'endpoint DELETE /batches/{ID} è stato dichiarato obsoleto. Per eliminare un batch, è necessario utilizzare l'API di acquisizione batch.
Parametro
Descrizione
{OBJECT_TYPE}

Tipo di oggetto Catalog da eliminare. Gli oggetti validi sono:

  • dataSets
  • dataSetFiles
{OBJECT_ID}
Identificatore dell’oggetto specifico da aggiornare.

Richiesta

La richiesta seguente elimina un set di dati il cui ID è specificato nel percorso della richiesta.

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}'

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 (OK) e un array contenente l’ID del set di dati eliminato. Questo ID deve corrispondere a quello inviato nella richiesta DELETE. L’esecuzione di una richiesta GET sull’oggetto eliminato restituisce lo stato HTTP 404 (Non trovato), confermando che il set di dati è stato eliminato correttamente.

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]
NOTE
Se nessun oggetto Catalog corrisponde all'ID fornito nella richiesta, è possibile ricevere comunque il codice di stato HTTP 200, ma l'array di risposta sarà vuoto.
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676