Eliminare un flusso di dati utilizzando l'API del servizio di flusso

Potete eliminare i flussi di dati batch e in streaming contenenti errori o obsoleti utilizzando l'API Flow Service API.

Questa esercitazione descrive i passaggi per eliminare i flussi di dati creati con origini batch e in streaming utilizzando Flow Service.

Introduzione

Questa esercitazione richiede un ID flusso valido. Se non si dispone di un ID di flusso valido, selezionare il connettore desiderato dalla scheda madre e seguire i passaggi descritti prima di eseguire l'esercitazione.

Questa esercitazione richiede inoltre di conoscere i seguenti componenti di Adobe Experience Platform:

  • Origini: Experience Platform consente l'acquisizione di dati da varie origini, fornendo al contempo la possibilità di strutturare, etichettare e migliorare i dati in arrivo tramite Platform i servizi.
  • Sandbox: Experience Platform fornisce sandbox virtuali che dividono una singola Platform istanza in ambienti virtuali separati per sviluppare e sviluppare applicazioni per esperienze digitali.

Le sezioni seguenti forniscono informazioni aggiuntive che sarà necessario conoscere per eliminare correttamente un flusso di dati utilizzando l'API Flow Service.

Lettura di chiamate API di esempio

Questa esercitazione fornisce esempi di chiamate API per dimostrare come formattare le richieste. Questi includono percorsi, intestazioni richieste e payload di richieste formattati correttamente. Viene inoltre fornito un JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, consultate la sezione relativa a come leggere chiamate API di esempio nella guida alla risoluzione dei problemi di Experience Platform.

Raccogli valori per le intestazioni richieste

Per effettuare chiamate alle Platform API, è innanzitutto necessario completare l'esercitazione sull'autenticazione a2/>. Completando l'esercitazione sull'autenticazione, vengono forniti i valori per ciascuna delle intestazioni richieste in tutte le chiamate API Experience Platform, come illustrato di seguito:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

Tutte le risorse in Experience Platform, incluse quelle appartenenti a Flow Service, sono isolate in sandbox virtuali specifiche. Tutte le richieste alle Platform API richiedono un'intestazione che specifica il nome della sandbox in cui verrà eseguita l'operazione:

  • x-sandbox-name: {SANDBOX_NAME}

Tutte le richieste che contengono un payload (POST, PUT, PATCH) richiedono un'intestazione aggiuntiva per il tipo di supporto:

  • Content-Type: application/json

Eliminare un flusso di dati

Con un ID flusso esistente, potete eliminare un flusso di dati eseguendo una richiesta di DELETE all'API Flow Service.

Formato API

DELETE /flows/{FLOW_ID}
Parametro Descrizione
{FLOW_ID} Valore id univoco per il flusso di dati da eliminare.

Richiesta

curl -X DELETE \
    'https://platform-int.adobe.io/data/foundation/flowservice/flows/20c115bc-46e3-40f3-bfe9-fb25abe4ba76' \
    -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 204 (Nessun contenuto) e un corpo vuoto. È possibile confermare l'eliminazione provando una richiesta di ricerca (GET) al flusso di dati. L'API restituirà un errore HTTP 404 (non trovato), a indicare che il flusso di dati è stato eliminato.

Passaggi successivi

Seguendo questa esercitazione, è stata utilizzata correttamente l'API Flow Service per eliminare un flusso di dati esistente.

Per i passaggi su come eseguire queste operazioni utilizzando l'interfaccia utente, fare riferimento all'esercitazione sull'eliminazione dei flussi di dati nell'interfaccia utente](…/…/tutorials/ui/delete.md)[

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free