Een doelgegevensstroom verwijderen met de Flow Service API

U kunt dataflows schrappen die fouten bevatten of verouderd zijn geworden gebruikend Flow Service API ​.

In deze zelfstudie worden de stappen beschreven voor het verwijderen van gegevensstromen naar zowel batchbestemmingen als streamingdoelen met Flow Service .

Aan de slag get-started

Voor deze zelfstudie hebt u een geldige stroom-id nodig. Als u geen geldige stroom identiteitskaart hebt, selecteer uw bestemming van keus van de ​ bestemmingscatalogus ​ en volg de stappen die aan ​ worden geschetst verbinden met de bestemming ​ en ​ activeren gegevens ​ alvorens dit leerprogramma te proberen.

Voor deze zelfstudie hebt u ook een goed inzicht nodig in de volgende onderdelen van Adobe Experience Platform:

De volgende secties bevatten aanvullende informatie die u moet weten om een gegevensstroom met de API Flow Service te kunnen verwijderen.

API-voorbeeldaanroepen lezen reading-sample-api-calls

Deze zelfstudie biedt voorbeeld-API-aanroepen om aan te tonen hoe uw verzoeken moeten worden opgemaakt. Dit zijn paden, vereiste kopteksten en correct opgemaakte ladingen voor aanvragen. Voorbeeld-JSON die wordt geretourneerd in API-reacties, wordt ook verschaft. Voor informatie over de overeenkomsten die in documentatie voor steekproef API vraag worden gebruikt, zie de sectie op ​ hoe te om voorbeeld API vraag ​ in de Experience Platform het oplossen van problemengids te lezen.

Waarden verzamelen voor vereiste koppen gather-values-for-required-headers

Om vraag aan Experience Platform APIs te maken, moet u het ​ authentificatieleerprogramma ​ eerst voltooien. Als u de zelfstudie over verificatie voltooit, krijgt u de waarden voor elk van de vereiste headers in alle API-aanroepen van Experience Platform , zoals hieronder wordt getoond:

Alle bronnen in Experience Platform, inclusief bronnen die tot Flow Service behoren, zijn geïsoleerd naar specifieke virtuele sandboxen. Alle aanvragen naar Experience Platform API's vereisen een header die de naam van de sandbox opgeeft waarin de bewerking plaatsvindt:

Alle verzoeken die een lading (POST, PUT, PATCH) bevatten vereisen een extra media typekopbal:

Doelgegevens verwijderen delete-destination-dataflow

Met een bestaande flow-id kunt u een doelgegevensstroom verwijderen door een DELETE-aanvraag uit te voeren naar de Flow Service API.

API formaat

DELETE /flows/{FLOW_ID}

Verzoek

curl -X DELETE \
    'https://platform.adobe.io/data/foundation/flowservice/flows/455fa81b-f290-4222-94b6-540a73e3fbc2' \
    -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}'

Reactie

Een geslaagde reactie retourneert HTTP-status 202 (Geen inhoud) en een lege hoofdtekst. U kunt de verwijdering bevestigen door een opzoekverzoek (GET) in te dienen bij de gegevensstroom. De API retourneert een HTTP 404 (Not Found)-fout die aangeeft dat de gegevensstroom is verwijderd.

API-foutafhandeling api-error-handling

De API-eindpunten in deze zelfstudie volgen de algemene beginselen van het Experience Platform API-foutbericht. Verwijs naar ​ API statuscodes ​ en ​ de fouten van de verzoekkopbal ​ in de het oplossen van problemengids van Experience Platform voor meer informatie bij het interpreteren van foutenreacties.

Volgende stappen next-steps

Door deze zelfstudie te volgen, hebt u de Flow Service API gebruikt om een bestaande gegevensstroom naar een doel te verwijderen.

Voor stappen op hoe te om deze verrichtingen uit te voeren die het gebruikersinterface gebruiken, gelieve te verwijzen naar het leerprogramma op ​ het schrappen van dataflows in UI ​.

U kunt nu op gaan en ​ bestemmingsrekeningen ​ schrappen gebruikend Flow Service API.