흐름 서비스 API를 사용하여 대상 데이터 흐름 삭제
다음을 사용하여 오류가 있거나 더 이상 사용되지 않는 데이터 흐름을 삭제할 수 있습니다. Flow Service API.
이 튜토리얼에서는 을 사용하여 일괄 처리 대상과 스트리밍 대상 모두에 대한 데이터 흐름을 삭제하는 단계를 설명합니다. Flow Service.
시작하기 get-started
이 자습서를 사용하려면 유효한 흐름 ID가 있어야 합니다. 유효한 흐름 ID가 없는 경우 대상 카탈로그 다음에 설명된 단계를 수행합니다. 대상에 연결 및 데이터 활성화 이 자습서를 시도하기 전에.
또한 이 자습서에서는 Adobe Experience Platform의 다음 구성 요소를 이해하고 있어야 합니다.
다음 섹션에서는 를 사용하여 데이터 흐름을 성공적으로 삭제하기 위해 알아야 하는 추가 정보를 제공합니다 Flow Service API.
샘플 API 호출 읽기 reading-sample-api-calls
이 튜토리얼에서는 요청 형식을 지정하는 방법을 보여 주는 예제 API 호출을 제공합니다. 여기에는 경로, 필수 헤더 및 적절한 포맷의 요청 페이로드가 포함됩니다. API 응답에서 반환되는 샘플 JSON도 제공됩니다. 샘플 API 호출에 대한 설명서에 사용되는 규칙에 대한 자세한 내용은 의 섹션을 참조하십시오. 예제 API 호출을 읽는 방법 다음에서 Experience Platform 문제 해결 가이드.
필수 헤더에 대한 값 수집 gather-values-for-required-headers
을 호출하기 위해 Platform API, 먼저 다음을 완료해야 합니다. 인증 자습서. 인증 자습서를 완료하면 모든 항목에서 필요한 각 헤더에 대한 값이 제공됩니다 Experience Platform 아래와 같이 API 호출:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
의 모든 리소스 Experience Platform, 다음에 속하는 항목 포함 Flow Service는 특정 가상 샌드박스로 분리됩니다. 에 대한 모든 요청 Platform API에는 작업이 수행될 샌드박스의 이름을 지정하는 헤더가 필요합니다.
x-sandbox-name: {SANDBOX_NAME}
x-sandbox-name
헤더가 지정되지 않았습니다. 요청은에서 확인됩니다. prod
샌드박스.페이로드(POST, PUT, PATCH)가 포함된 모든 요청에는 추가 미디어 유형 헤더가 필요합니다.
Content-Type: application/json
대상 데이터 흐름 삭제 delete-destination-dataflow
기존 흐름 ID를 사용하여에 대한 DELETE 요청을 수행하여 대상 데이터 흐름을 삭제할 수 있습니다. Flow Service API.
API 형식
DELETE /flows/{FLOW_ID}
{FLOW_ID}
id
삭제할 대상 데이터 흐름의 값입니다.요청
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}'
응답
성공적인 응답은 HTTP 상태 202(콘텐츠 없음) 및 빈 본문을 반환합니다. 데이터 흐름에 조회(GET) 요청을 시도하여 삭제를 확인할 수 있습니다. API가 데이터 흐름이 삭제되었음을 나타내는 HTTP 404(찾을 수 없음) 오류를 반환합니다.
API 오류 처리 api-error-handling
이 자습서의 API 끝점은 일반적인 Experience Platform API 오류 메시지 원칙을 따릅니다. 을(를) 참조하십시오 API 상태 코드 및 요청 헤더 오류 오류 응답 해석에 대한 자세한 내용은 플랫폼 문제 해결 안내서를 참조하십시오.
다음 단계 next-steps
이 자습서에 따라 Flow Service 대상으로 기존 데이터 흐름을 삭제하기 위한 API입니다.
사용자 인터페이스를 사용하여 이러한 작업을 수행하는 방법에 대한 단계는 의 자습서를 참조하십시오. UI에서 데이터 흐름 삭제.
이제 계속하고 대상 계정 삭제 사용 Flow Service API.