Ta bort ett måldataflöde med API:t för Flow Service
Du kan ta bort dataflöden som innehåller fel eller som har blivit föråldrade med Flow Service API.
I den här självstudien beskrivs stegen för att ta bort dataflöden till både batch- och direktuppspelningsmål med hjälp av Flow Service.
Komma igång get-started
Den här självstudiekursen kräver att du har ett giltigt flödes-ID. Om du inte har något giltigt flöde-ID väljer du önskat mål i målkatalogen och följer instruktionerna som beskrivs för att ansluta till målet och aktivera data innan du provar den här självstudiekursen.
Den här självstudiekursen kräver även att du har en fungerande förståelse för följande komponenter i Adobe Experience Platform:
- Destinationer: Destinations är färdiga integreringar med målplattformar som möjliggör smidig aktivering av data från Adobe Experience Platform. Ni kan använda destinationer för att aktivera kända och okända data för flerkanalskampanjer, e-postkampanjer, riktad reklam och många andra användningsfall.
- Sandlådor: Experience Platform innehåller virtuella sandlådor som partitionerar en enskild Platform-instans till separata virtuella miljöer för att hjälpa till att utveckla och utveckla program för digitala upplevelser.
I följande avsnitt finns ytterligare information som du behöver känna till för att kunna ta bort ett dataflöde med API:t Flow Service.
Läser exempel-API-anrop reading-sample-api-calls
I den här självstudiekursen finns exempel-API-anrop som visar hur du formaterar dina begäranden. Det kan vara sökvägar, obligatoriska rubriker och korrekt formaterade begärandenyttolaster. Ett exempel på JSON som returneras i API-svar finns också. Information om de konventioner som används i dokumentationen för exempel-API-anrop finns i avsnittet Så här läser du exempel-API-anrop i felsökningsguiden för Experience Platform.
Samla in värden för obligatoriska rubriker gather-values-for-required-headers
För att kunna anropa Platform API:er måste du först slutföra autentiseringssjälvstudiekursen. När du slutför självstudiekursen för autentisering visas värdena för var och en av de obligatoriska rubrikerna i alla Experience Platform API-anrop, vilket visas nedan:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Alla resurser i Experience Platform, inklusive de som tillhör Flow Service, isoleras till specifika virtuella sandlådor. Alla begäranden till Platform API:er kräver en rubrik som anger namnet på sandlådan som åtgärden ska utföras i:
x-sandbox-name: {SANDBOX_NAME}
x-sandbox-name inte anges löses förfrågningar under sandlådan prod.Alla begäranden som innehåller en nyttolast (POST, PUT, PATCH) kräver ytterligare en medietypsrubrik:
Content-Type: application/json
Ta bort ett måldataflöde delete-destination-dataflow
Med ett befintligt flödes-ID kan du ta bort ett måldataflöde genom att utföra en DELETE-begäran till Flow Service-API:t.
API-format
DELETE /flows/{FLOW_ID}
{FLOW_ID}id-värdet för måldataflödet som du vill ta bort.Begäran
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}'
Svar
Ett lyckat svar returnerar HTTP-status 202 (inget innehåll) och en tom brödtext. Du kan bekräfta borttagningen genom att försöka utföra en sökbegäran (GET) i dataflödet. API returnerar ett HTTP 404-fel (Hittades inte) som anger att dataflödet har tagits bort.
API-felhantering api-error-handling
API-slutpunkterna i den här självstudiekursen följer de allmänna felmeddelandeprinciperna för Experience Platform API. Mer information om hur du tolkar felsvar finns i API-statuskoder och begäranrubrikfel i felsökningsguiden för plattformen.
Nästa steg next-steps
Genom att följa den här självstudiekursen har du använt API:t Flow Service för att ta bort ett befintligt dataflöde till ett mål.
Anvisningar om hur du utför dessa åtgärder med användargränssnittet finns i självstudiekursen Ta bort dataflöden i användargränssnittet.
Du kan nu fortsätta och ta bort målkonton med API:t Flow Service.