Puede eliminar flujos de datos que contengan errores o que se hayan vuelto obsoletos mediante la función Flow Service API.
Este tutorial trata los pasos para eliminar flujos de datos tanto a destinos de lote como de flujo continuo mediante Flow Service.
Este tutorial requiere que tenga un ID de flujo válido. Si no tiene un ID de flujo válido, seleccione el destino que desee en el catálogo de destinos y siga los pasos descritos para conectarse al destino y activar datos antes de intentar este tutorial.
Este tutorial también requiere que tenga una comprensión práctica de los siguientes componentes de Adobe Experience Platform:
Las secciones siguientes proporcionan información adicional que deberá conocer para eliminar correctamente un flujo de datos mediante el Flow Service API.
Este tutorial proporciona llamadas de API de ejemplo para demostrar cómo dar formato a las solicitudes. Estas incluyen rutas de acceso, encabezados necesarios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de API. Para obtener información sobre las convenciones utilizadas en la documentación para las llamadas de API de ejemplo, consulte la sección sobre cómo leer llamadas de API de ejemplo en el Experience Platform guía de solución de problemas.
Para realizar llamadas a Platform API, primero debe completar la variable tutorial de autenticación. Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados necesarios en todos los Experience Platform Llamadas de API, como se muestra a continuación:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
Todos los recursos de Experience Platform, incluidas las pertenecientes a Flow Service, están aisladas para entornos limitados virtuales específicos. Todas las solicitudes a Platform Las API requieren un encabezado que especifique el nombre del simulador para pruebas en el que se realizará la operación:
x-sandbox-name: {SANDBOX_NAME}
Si la variable x-sandbox-name
no se ha especificado, las solicitudes se resuelven en la sección prod
simulador de pruebas.
Todas las solicitudes que contienen una carga útil (POST, PUT, PATCH) requieren un encabezado de tipo de medio adicional:
Content-Type: application/json
Con un ID de flujo existente, puede eliminar un flujo de datos de destino realizando una solicitud de DELETE al Flow Service API.
Formato de API
DELETE /flows/{FLOW_ID}
Parámetro | Descripción |
---|---|
{FLOW_ID} |
El único id para el flujo de datos de destino que desea eliminar. |
Solicitud
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}'
Respuesta
Una respuesta correcta devuelve el estado HTTP 202 (sin contenido) y un cuerpo en blanco. Puede confirmar la eliminación intentando realizar una solicitud de búsqueda (GET) al flujo de datos. La API devolverá un error HTTP 404 (no encontrado), que indica que se ha eliminado el flujo de datos.
Los extremos de API de este tutorial siguen los principios generales del mensaje de error de la API del Experience Platform. Consulte Códigos de estado de API y errores en el encabezado de la solicitud en la guía de solución de problemas de Platform para obtener más información sobre la interpretación de las respuestas de error.
Al seguir este tutorial, ha utilizado correctamente la variable Flow Service API para eliminar un flujo de datos existente a un destino.
Para ver los pasos sobre cómo realizar estas operaciones mediante la interfaz de usuario, consulte el tutorial sobre eliminación de flujos de datos en la interfaz de usuario.
Ahora puede continuar y eliminar cuentas de destino usando la variable Flow Service API.