프로필 시스템 작업 끝점(요청 삭제)
Adobe Experience Platform을 사용하면 여러 소스에서 데이터를 수집하고 개별 고객을 위한 강력한 프로필을 구축할 수 있습니다. 데이터 수집됨 Platform 에 저장됩니다. Data Lake, 그리고 데이터 세트가 프로필에 대해 활성화된 경우 해당 데이터는에 저장됩니다. Real-Time Customer Profile 데이터 저장소도 있습니다. 더 이상 필요하지 않거나 오류로 추가된 데이터를 제거하기 위해 프로필 저장소에서 데이터 세트 또는 배치를 삭제해야 하는 경우가 있습니다. 이를 위해서는 를 사용해야 합니다. Real-Time Customer Profile 만들기 위한 API Profile 시스템 작업 또는 delete request
필요한 경우 수정, 모니터링 또는 제거할 수도 있습니다.
시작하기
이 안내서에 사용된 API 끝점은 Real-Time Customer Profile API. 계속하기 전에 다음을 검토하십시오. 시작 안내서 관련 설명서에 대한 링크, 이 문서의 샘플 API 호출 읽기에 대한 안내서 및 Experience Platform API를 성공적으로 호출하는 데 필요한 필수 헤더에 대한 중요 정보입니다.
삭제 요청 보기
삭제 요청은 오래 실행되는 비동기 프로세스입니다. 즉, 조직에서 한 번에 여러 삭제 요청을 실행할 수 있습니다. 조직에서 현재 실행 중인 모든 삭제 요청을 보기 위해에 대한 GET 요청을 수행할 수 있습니다. /system/jobs
엔드포인트.
선택적 쿼리 매개 변수를 사용하여 응답에서 반환되는 삭제 요청 목록을 필터링할 수도 있습니다. 여러 매개 변수를 사용하려면 앰퍼샌드(&
).
API 형식
GET /system/jobs
GET /system/jobs?{QUERY_PARAMETERS}
start
start=4
limit
limit=10
page
page=2
sort
asc
) 또는 내림차순(desc
) 순서. 여러 결과 페이지를 반환할 때 정렬 매개 변수가 작동하지 않습니다. 예: sort=batchId:asc
요청
curl -X GET \
https://platform.adobe.io/data/core/ups/system/jobs \
-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}' \
응답
응답에는 해당 요청의 세부 사항이 포함된 각 삭제 요청에 대한 오브젝트가 있는 "하위" 배열이 포함됩니다.
{
"_page": {
"count": 100,
"next": "K1JJRDpFaWc5QUwyZFgtMEpBQUFBQUFBQUFBPT0jUlQ6MSNUUkM6MiNGUEM6QWdFQUFBQVFBQWZBQUg0Ly9yL25PcmpmZndEZUR3QT0="
},
"children": [
{
"id": "9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4",
"imsOrgId": "{ORG_ID}",
"batchId": "8d075b5a178e48389126b9289dcfd0ac",
"jobType": "DELETE",
"status": "COMPLETED",
"metrics": "{\"recordsProcessed\":5,\"timeTakenInSec\":1}",
"createEpoch": 1559026134,
"updateEpoch": 1559026137
},
{
"id": "3f225e7e-ac8c-4904-b1d5-0ce79e03c2ec",
"imsOrgId": "{ORG_ID}",
"dataSetId": "5c802d3cd83fc114b741c4b5",
"jobType": "DELETE",
"status": "PROCESSING",
"metrics": "{\"recordsProcessed\":0,\"timeTakenInSec\":15}",
"createEpoch": 1559025404,
"updateEpoch": 1559025406
}
]
}
_page.count
_page.next
"next"
값을 입력했습니다.jobType
"DELETE"
.status
"NEW"
, "PROCESSING"
, "COMPLETED"
, "ERROR"
.metrics
"recordsProcessed"
) 요청이 처리되는 시간(초) 또는 요청이 완료되는 데 걸린 시간("timeTakenInSec"
).삭제 요청 만들기 create-a-delete-request
새 삭제 요청을 시작하는 것은 (으)로의 POST 요청을 통해 수행됩니다. /systems/jobs
삭제할 데이터 세트 또는 배치의 ID가 요청 본문에 제공되는 종단점입니다.
데이터 세트 삭제
프로필 스토어에서 데이터 세트를 삭제하려면 데이터 세트 ID가 POST 요청 본문에 포함되어야 합니다. 이 작업은 주어진 데이터 세트에 대한 모든 데이터를 삭제합니다. Experience Platform 레코드 및 시계열 스키마를 모두 기반으로 데이터 세트를 삭제할 수 있습니다.
API 형식
POST /system/jobs
요청
curl -X POST \
https://platform.adobe.io/data/core/ups/system/jobs \
-H 'Content-Type: application/json' \
-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}' \
-d '{
"dataSetId": "5c802d3cd83fc114b741c4b5"
}'
dataSetId
응답
성공적인 응답은 요청에 대한 고유한 시스템 생성 읽기 전용 ID를 포함하여 새로 생성된 삭제 요청의 세부 정보를 반환합니다. 요청을 검색하고 상태를 확인하는 데 사용할 수 있습니다. 다음 status
생성 시 요청에 대한 은(는) 입니다. "NEW"
처리를 시작할 때까지. 다음 dataSetId
응답에서 은(는) dataSetId
요청에서 전송되었습니다.
{
"id": "3f225e7e-ac8c-4904-b1d5-0ce79e03c2ec",
"imsOrgId": "{ORG_ID}",
"dataSetId": "5c802d3cd83fc114b741c4b5",
"jobType": "DELETE",
"status": "NEW",
"createEpoch": 1559025404,
"updateEpoch": 1559025406
}
id
dataSetId
일괄 처리 삭제
배치를 삭제하려면 배치 ID가 POST 요청 본문에 포함되어야 합니다. 레코드 스키마를 기반으로 데이터 세트에 대한 배치를 삭제할 수 없습니다. 시계열 스키마를 기반으로 하는 데이터 세트의 배치만 삭제할 수 있습니다.
레코드 및 시계열 동작에 대한 자세한 내용은 xdm 데이터 동작에 대한 섹션 다음에서 XDM System 개요.
API 형식
POST /system/jobs
요청
curl -X POST \
https://platform.adobe.io/data/core/ups/system/jobs \
-H 'Content-Type: application/json' \
-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}' \
-d '{
"batchId": "8d075b5a178e48389126b9289dcfd0ac"
}'
batchId
응답
성공적인 응답은 요청에 대한 고유한 시스템 생성 읽기 전용 ID를 포함하여 새로 생성된 삭제 요청의 세부 정보를 반환합니다. 요청을 검색하고 상태를 확인하는 데 사용할 수 있습니다. 다음 "status"
생성 시 요청에 대한 은(는) 입니다. "NEW"
처리를 시작할 때까지. 다음 "batchId"
응답의 값은 "batchId"
요청에서 전송된 값입니다.
{
"id": "9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4",
"imsOrgId": "{ORG_ID}",
"batchId": "8d075b5a178e48389126b9289dcfd0ac",
"jobType": "DELETE",
"status": "NEW",
"createEpoch": 1559026131,
"updateEpoch": 1559026132
}
id
batchId
레코드 데이터 세트 배치에 대한 삭제 요청을 시작하려고 하면 다음과 유사한 400 수준 오류가 발생합니다.
{
"requestId": "bc4eb29f-63a8-4653-9133-71238884bb81",
"errors": {
"400": [
{
"code": "500",
"message": "Batch can only be specified for EE type 'a294e36d382649dab2cc6ad64a41b674'"
}
]
}
}
특정 삭제 요청 보기 view-a-specific-delete-request
GET 상태와 같은 세부 정보를 포함하여 특정 삭제 요청을 보려면 /system/jobs
엔드포인트를 추가하고 경로에 삭제 요청의 ID를 포함합니다.
API 형식
GET /system/jobs/{DELETE_REQUEST_ID}
{DELETE_REQUEST_ID}
요청
curl -X GET \
https://platform.adobe.io/data/core/ups/system/jobs/9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4 \
-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}' \
응답
응답은 업데이트된 상태를 포함하여 삭제 요청의 세부 정보를 제공합니다. 응답의 삭제 요청 ID(다음 항목 포함) "id"
value)는 요청 경로에서 전송된 ID와 일치해야 합니다.
{
"id": "9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4",
"imsOrgId": "{ORG_ID}",
"batchId": "8d075b5a178e48389126b9289dcfd0ac",
"jobType": "DELETE",
"status": "COMPLETED",
"metrics": "{\"recordsProcessed\":5,\"timeTakenInSec\":1}",
"createEpoch": 1559026134,
"updateEpoch": 1559026137
}
jobType
"DELETE"
.status
"NEW"
, "PROCESSING"
, "COMPLETED"
, "ERROR"
.metrics
"recordsProcessed"
) 요청이 처리되는 시간(초) 또는 요청이 완료되는 데 걸린 시간("timeTakenInSec"
).삭제 요청 상태가 다음과 같으면 "COMPLETED"
데이터 액세스 API를 사용하여 삭제된 데이터에 액세스하려고 하면 해당 데이터가 삭제되었음을 확인할 수 있습니다. 데이터 액세스 API를 사용하여 데이터 세트 및 배치에 액세스하는 방법에 대한 지침은 데이터 액세스 설명서.
삭제 요청 제거
Experience Platform 이전 요청을 삭제할 수 있도록 허용합니다. 이 작업은 삭제 작업이 완료되지 않았거나 처리 단계에서 중단된 경우를 포함하여 여러 가지 이유로 유용할 수 있습니다. 삭제 요청을 제거하기 위해에 대한 DELETE 요청을 수행할 수 있습니다. /system/jobs
엔드포인트를 추가하고 제거할 삭제 요청의 ID를 요청 경로에 포함합니다.
API 형식
DELETE /system/jobs/{DELETE_REQUEST_ID}
요청
curl -X POST \
https://platform.adobe.io/data/core/ups/system/jobs/9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4 \
-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 상태 200(OK)과 빈 응답 본문을 반환합니다. ID로 삭제 요청을 보려면 GET 요청을 수행하여 요청이 삭제되었는지 확인할 수 있습니다. 삭제 요청이 제거되었음을 나타내는 HTTP 상태 404(찾을 수 없음)가 반환됩니다.
다음 단계
이제에서 데이터 세트 및 배치 삭제와 관련된 단계를 이해했습니다. Profile Store 다음 범위 내 Experience Platform, 잘못 추가되었거나 조직에 더 이상 필요하지 않은 데이터를 안전하게 삭제할 수 있습니다. 삭제 요청은 실행 취소할 수 없으므로 지금은 필요하지 않고 미래에는 필요하지 않다고 확신하는 데이터만 삭제해야 합니다.