프로필 시스템 작업 끝점(요청 삭제)

마지막 업데이트: 2026년 4월 6일

주제:
Profiles

작성 대상:

Developer

Adobe Experience Platform을 사용하면 여러 소스에서 데이터를 수집하고 개별 고객을 위한 강력한 프로필을 구축할 수 있습니다. Experience Platform에 수집된 데이터는 Data Lake에 저장되며, 프로필에 대해 데이터 세트를 사용하도록 설정한 경우 해당 데이터도 Real-Time Customer Profile 데이터 저장소에 저장됩니다. 더 이상 필요하지 않거나 오류로 추가된 데이터를 제거하기 위해 프로필 저장소에서 데이터 세트와 연결된 프로필 데이터를 삭제해야 하는 경우가 있습니다. Real-Time Customer Profile API를 사용하여 Profile 시스템 작업 또는 "삭제 요청"을 만들어야 합니다.

NOTE

Data Lake에서 데이터 세트 또는 배치를 삭제하려면 카탈로그 서비스 개요에서 자세한 내용을 확인하십시오.

시작

이 가이드에 사용된 API 끝점은 Real-Time Customer Profile API의 일부입니다. 계속하기 전에 시작 안내서를 검토하여 관련 문서에 대한 링크, 이 문서의 샘플 API 호출 읽기 지침 및 Experience Platform API를 성공적으로 호출하는 데 필요한 필수 헤더에 대한 중요 정보를 확인하십시오.

삭제 요청 보기 view

삭제 요청은 오래 실행되는 비동기 프로세스입니다. 즉, 조직에서 한 번에 여러 삭제 요청을 실행할 수 있습니다. 조직에서 현재 실행 중인 모든 삭제 요청을 보려면 /system/jobs 끝점에 대한 GET 요청을 수행할 수 있습니다.

선택적 쿼리 매개 변수를 사용하여 응답에서 반환되는 삭제 요청 목록을 필터링할 수도 있습니다. 여러 매개 변수를 사용하려면 앰퍼샌드(&)를 사용하여 각 매개 변수를 구분하십시오.

API 형식

이 끝점을 사용하는 경우 처음 100개의 시스템 작업이 생성 날짜에 따라 오름차순으로 반환됩니다.

GET /system/jobs
GET /system/jobs?{QUERY_PARAMETERS}

매개 변수

설명

예

start

반환된 결과 세트의 시작 페이지를 결정합니다. 페이지 번호는 0을 기준으로 합니다. 즉, start=0이(가) 0부터 시작하는 결과를 반환합니다.

start=4

limit

페이지당 반환되는 결과 수.

limit=10

예를 들어 쿼리 매개 변수가 ?start=1&limit=10인 경우 응답은 레코드 10-19를 반환합니다.

요청

시스템 작업을 보기 위한 샘플 요청입니다.

code language-shell

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}' \

응답

성공적인 응답은 각 시스템 요청에 대한 개체를 포함하는 하위 배열과 페이지 정보를 반환합니다.

시스템 요청 보기에 대한 성공적인 응답

code language-json

{
    "_page": {
        "pageSize": 2,
        "start": "0",
        "totalCount": 2,
        "next": 1
    },
    "children:" [
        {
            "requestId": "80a9405a-21ca-4278-aedf-99367f90c055",
            "requestType": "DELETE_EE_BATCH",
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxName": "prod",
                "sandboxId": "8129954b-fa83-43ba-a995-4bfa8373ba2b"
            },
            "status": "SUCCESS",
            "properties": {
                "batchId": "01JFSYFDFW9JAAEKHX672JMPSB",
                "datasetId": "66a92c5910df2d1767de13f3"
            },
            "createdAt": "2024-12-22T19:44:50.250006Z",
            "updatedAt": "2024-12-22T19:52:13.380706Z"
        },
        {
            "requestId": "38a835eb-b491-4864-902b-be07fa4d6a6d",
            "requestType": "TRUNCATE_DATASET",
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxName": "prod",
                "sandboxId": "8129954b-fa83-43ba-a995-4bfa8373ba2b"
            },
            "status": "SUCCESS",
            "properties": {
                "datasetId": "66a92c5910df2d1767de13f3"
            },
            "createdAt": "2024-12-22T19:44:50.250006Z",
            "updatedAt": "2024-12-22T19:52:13.380706Z"
        }
    ]
}

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
속성	설명
`requestId`	시스템 작업의 ID입니다.
`requestType`	시스템 작업 유형입니다. 가능한 값은 `BACKFILL_TTL`, `DELETE_EE_BATCH` 및 `TRUNCATE_DATASET`입니다.
`status`	시스템 작업의 상태입니다. 가능한 값은 `NEW`, `SUCCESS`, `ERROR`, `FAILED` 및 `IN-PROGRESS`입니다.
`properties`	시스템 작업의 배치 및/또는 데이터 세트 ID를 포함하는 객체입니다.

삭제 요청 만들기 create-a-delete-request

새 삭제 요청을 시작하는 작업은 /systems/jobs 끝점에 대한 POST 요청을 통해 수행됩니다. 여기서 삭제할 데이터 세트 또는 배치의 ID는 요청 본문에 제공됩니다.

데이터 세트 및 관련 프로필 데이터 삭제

프로필 저장소에서 데이터 세트 및 데이터 세트와 연결된 모든 프로필 데이터를 삭제하려면 데이터 세트 ID를 POST 요청의 본문에 포함해야 합니다. 이 작업은 주어진 데이터 세트에 대한 모든 데이터를 삭제합니다. Experience Platform을(를) 사용하면 레코드와 시계열 스키마를 기준으로 데이터 세트를 삭제할 수 있습니다.

API 형식

POST /system/jobs

요청

데이터 세트 삭제에 대한 샘플 요청입니다.

code language-shell

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": "66a92c5910df2d1767de13f3"
      }'

속성

설명

dataSetId

삭제할 데이터 세트의 ID입니다.

응답

성공한 응답은 요청에 대한 고유한 시스템 생성 읽기 전용 ID를 포함하여 새로 생성된 시스템 요청의 세부 정보를 반환합니다. 요청을 검색하고 상태를 확인하는 데 사용할 수 있습니다. 생성 시 요청의 status은(는) 처리를 시작할 때까지 NEW입니다(IN-PROGRESS). 응답의 dataSetId는 요청에서 보낸 dataSetId과(와) 일치해야 합니다.

삭제 요청 생성에 대한 성공적인 응답입니다.

code language-json

{
    "requestId": "80a9405a-21ca-4278-aedf-99367f90c055",
    "requestType": "TRUNCATE_DATASET",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxName": "prod",
        "sandboxId": "8129954b-fa83-43ba-a995-4bfa8373ba2b"
    },
    "status": "NEW",
    "properties": {
        "datasetId": "66a92c5910df2d1767de13f3"
    },
    "createdAt": "2024-12-22T19:44:50.250006Z",
    "updatedAt": "2024-12-22T19:44:50.250006Z"
}

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
속성	설명
`requestId`	시스템 작업의 시스템 생성 읽기 전용 ID입니다.
`requestType`	시스템 작업 유형입니다. 데이터 집합을 삭제하고 있으므로 이 값은 `TRUNCATE_DATASET`입니다.
`status`	시스템 작업의 상태입니다. 가능한 값은 `NEW`, `SUCCESS`, `ERROR`, `FAILED` 및 `IN-PROGRESS`입니다.
`properties`	시스템 작업의 데이터 세트 ID를 포함하는 개체입니다.

일괄 처리 삭제

배치를 삭제하려면 배치 ID가 POST 요청의 본문에 포함되어야 합니다. 레코드 스키마를 기반으로 데이터 세트에 대한 배치를 삭제할 수 없습니다. 시계열 스키마를 기반으로 하는 데이터 세트의 배치만 삭제할 수 있습니다.

NOTE

레코드 스키마를 기반으로 데이터 세트 배치를 삭제할 수 없는 이유는 레코드 유형 데이터 세트 배치가 이전 레코드를 덮어쓰므로 "실행 취소" 또는 삭제할 수 없기 때문입니다. 레코드 스키마를 기반으로 데이터 세트에 대한 잘못된 배치의 영향을 제거하는 유일한 방법은 잘못된 레코드를 덮어쓰기 위해 배치를 올바른 데이터로 다시 수집하는 것입니다.

레코드 및 시계열 동작에 대한 자세한 내용은 XDM System 개요에서 XDM 데이터 동작에 대한 섹션을 검토하십시오.

API 형식

POST /system/jobs

요청

배치 삭제에 대한 샘플 요청입니다.

code language-shell

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": "66a92c5910df2d1767de13f3",
        "batchId": "01JFSYFDFW9JAAEKHX672JMPSB"
      }'

속성

설명

datasetId

삭제하려는 배치에 대한 데이터 세트 ID입니다.

batchId

삭제하려는 일괄 처리의 ID입니다.

응답

성공한 응답은 새로 생성된 시스템 요청의 세부 정보를 반환합니다.

삭제 요청 생성에 대한 성공적인 응답입니다.

code language-json

{
    "requestId": "80a9405a-21ca-4278-aedf-99367f90c055",
    "requestType": "DELETE_EE_BATCH",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxName": "prod",
        "sandboxId": "8129954b-fa83-43ba-a995-4bfa8373ba2b"
    },
    "status": "NEW",
    "properties": {
        "datasetId": "66a92c5910df2d1767de13f3",
        "batchId": "01JFSYFDFW9JAAEKHX672JMPSB"
    },
    "createdAt": "2024-12-22T19:44:50.250006Z",
    "updatedAt": "2024-12-22T19:44:50.250006Z"
}

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
속성	설명
`requestId`	시스템 작업의 시스템 생성 읽기 전용 ID입니다.
`requestType`	시스템 작업 유형입니다. 일괄 처리를 삭제하는 중이므로 이 값은 `DELETE_EE_BATCH`입니다.
`status`	시스템 작업의 상태입니다. 가능한 값은 `NEW`, `SUCCESS`, `ERROR`, `FAILED` 및 `IN-PROGRESS`입니다.
`properties`	시스템 작업의 배치 및 데이터 세트 ID를 포함하는 객체입니다.

레코드 데이터 세트 배치에 대한 삭제 요청을 시작하려고 하면 요청이 실패합니다.

특정 삭제 요청 보기 view-a-specific-delete-request

상태 등 세부 정보를 포함하여 특정 삭제 요청을 보려면 /system/jobs 끝점에 대한 조회(GET) 요청을 수행하고 경로에 삭제 요청의 ID를 포함할 수 있습니다.

API 형식

GET /system/jobs/{DELETE_REQUEST_ID}

매개 변수

설명

{DELETE_REQUEST_ID}

보려는 삭제 요청의 ID입니다.

요청

프로필 작업을 보기 위한 샘플 요청입니다.

code language-shell

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와 일치해야 합니다.

삭제 요청 보기에 대한 성공적인 응답입니다.

code language-json

{
    "requestId": "9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4",
    "requestType": "DELETE_EE_BATCH",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxName": "prod",
        "sandboxId": "8129954b-fa83-43ba-a995-4bfa8373ba2b"
    },
    "status": "SUCCESS",
    "properties": {
        "batchId": "01JFSYFDFW9JAAEKHX672JMPSB",
        "datasetId": "66a92c5910df2d1767de13f3"
    },
    "createdAt": "2024-12-22T19:44:50.250006Z",
    "updatedAt": "2024-12-22T19:52:13.380706Z"
}

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
속성	설명
`requestId`	시스템 작업의 시스템 생성 읽기 전용 ID입니다.
`requestType`	시스템 작업 유형입니다. 가능한 값은 `BACKFILL_TTL`, `DELETE_EE_BATCH` 및 `TRUNCATE_DATASET`입니다.
`status`	시스템 작업의 상태입니다. 가능한 값은 `NEW`, `SUCCESS`, `ERROR`, `FAILED` 및 `IN-PROGRESS`입니다.
`properties`	시스템 작업의 배치 및/또는 데이터 세트 ID를 포함하는 객체입니다.

삭제 요청 상태가 "SUCCESS"이면 데이터 액세스 API를 사용하여 삭제된 데이터에 액세스함으로써 데이터가 삭제되었음을 확인할 수 있습니다. 데이터 액세스 API를 사용하여 데이터 세트 및 배치에 액세스하는 방법에 대한 지침은 데이터 액세스 설명서를 참조하십시오.

다음 단계

Experience Platform 내의 Profile store에서 데이터 세트 및 배치를 삭제하는 단계를 알았으므로 잘못 추가되었거나 조직에 더 이상 필요하지 않은 데이터를 안전하게 삭제할 수 있습니다. 삭제 요청은 실행 취소할 수 없으므로 지금은 필요하지 않고 미래에는 필요하지 않다고 확신하는 데이터만 삭제해야 합니다.

recommendation-more-help

experience-platform-help-profile