Documentazione Experience Platform Guida al catalogo e ai set di dati

Eliminare un oggetto nell’API

16 luglio 2024

Argomenti:
Catalogo

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