Eliminare un oggetto nell’API

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

AVVERTENZA

Presta particolare attenzione durante l’eliminazione degli oggetti, poiché questa operazione non può essere annullata e potrebbe causare modifiche di interruzione altrove in Experience Platform.

Formato API

DELETE /{OBJECT_TYPE}/{OBJECT_ID}
IMPORTANTE

L’endpoint DELETE /batches/{ID} è stato dichiarato obsoleto. Per eliminare un batch, devi utilizzare l' API di acquisizione batch.

Parametro Descrizione
{OBJECT_TYPE} Il tipo di oggetto Catalog da eliminare. Gli oggetti validi sono:
  • accounts
  • connections
  • dataSets
  • dataSetFiles
  • dataSetViews
{OBJECT_ID} Identificatore dell'oggetto specifico che si desidera aggiornare.

Richiesta

La seguente richiesta 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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Risposta

Una risposta corretta restituisce lo stato HTTP 200 (OK) e una matrice contenente l'ID del set di dati eliminato. Questo ID deve corrispondere a quello inviato nella richiesta di DELETE. L'esecuzione di una richiesta di GET sull'oggetto eliminato restituisce lo stato HTTP 404 (Non trovato), confermando che il set di dati è stato eliminato correttamente.

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]
NOTA

Se nessun oggetto Catalog corrisponde all’ID fornito nella richiesta, è comunque possibile che si riceva un codice di stato HTTP 200, ma l’array di risposta sarà vuoto.

In questa pagina