プロファイルシステムジョブエンドポイント(削除リクエスト)

IMPORTANT
次のエンドポイントは、Microsoft Azure で実行されているAdobe Experience Platformの実装とAmazon Web Services(AWS)で異なる場合があります。 AWSで実行されるExperience Platformは、現在、限られた数のお客様が利用できます。 サポートされるExperience Platformインフラストラクチャについて詳しくは、Experience Platformマルチクラウドの概要を参照してください。

Adobe Experience Platform を使用すると、複数のソースからデータを取得し、個々の顧客に対して堅牢なプロファイルを構築できます。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 形式

AVAILABILITY
Microsoft Azure で Platform を使用する場合は、次のクエリパラメーター のみ を使用できます。
AWSでこのエンドポイントを使用すると、最初の 100 個のシステムジョブが作成日に基づいて降順で返されます。
GET /system/jobs
GET /system/jobs?{QUERY_PARAMETERS}
パラメーター
説明
start
リクエストの作成時間ごとに、返される結果のページをオフセットします。
start=4
limit
返される結果の数を制限します。
limit=10
page
リクエストの作成時間ごとに、特定の結果ページを返します。
page=2
sort
特定のフィールドで結果を昇順(asc)または降順(desc)で並べ替えます。結果の複数のページを返す場合、並べ替えパラメーターは機能しません。
sort=batchId:asc

リクエスト

IMPORTANT
次のリクエストは、Azure インスタンスとAWS インスタンスで異なります。
Microsoft Azure
accordion
システムジョブを表示するためのサンプルリクエスト。
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}' \
Amazon Web Services(AWS)
note important
IMPORTANT
このエンドポイントをAWSで使用する場合は x-sandbox-name リクエストヘッダーではなく x-sandbox-id リクエストヘッダーを使用する 必要があります)。
accordion
システムジョブを表示するためのサンプルリクエスト。
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-id: {SANDBOX_ID}' \

応答

IMPORTANT
次の応答は、Azure インスタンスとAWS インスタンスで異なります。
Microsoft Azure

正常な応答には「子」配列と、そのリクエストの詳細を含む各削除リクエストのオブジェクトが含まれています。

accordion
削除リクエストの表示に成功した応答
code language-json
{
  "_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
    }
  ]
}
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
プロパティ 説明
_page.count リクエストの合計数。この応答はスペースを節約するために切り捨てられています。
_page.next 結果の追加のページが存在する場合は、 参照リクエストの ID 値を指定された "next" 値に置き換えて、結果の次のページを表示します。
jobType 作成されるジョブのタイプ。この場合、常に "DELETE" が返されます。
status 削除リクエストのステータス。使用可能な値は、"NEW""PROCESSING""COMPLETED""ERROR" などです。
metrics 処理されたレコードの数("recordsProcessed")、リクエストが処理された時間(秒)、またはリクエストが完了するまでにかかった時間("timeTakenInSec")を含むオブジェクト。
Amazon Web Services(AWS)

応答が成功すると、各システムリクエストのオブジェクトを含む配列が返されます。

accordion
システムリクエストを表示するための正常な応答
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": "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_TTLDELETE_EE_BATCHTRUNCATE_DATASET です。
status システムジョブのステータス。 使用可能な値は、NEWSUCCESSERRORFAILEDIN-PROGRESS などです。
properties システムジョブのバッチ ID やデータセット ID を含むオブジェクト。

削除リクエストの作成 create-a-delete-request

新しい削除リクエストの開始は、/systems/jobs エンドポイントへの POST リクエストを通じて行われます。このエンドポイントでは、削除するデータセットまたはバッチの ID がリクエストの本文に表示されます。

データセットおよび関連するプロファイルデータの削除

データセットとそれに関連付けられたすべてのプロファイルデータをプロファイルストアから削除するには、データセット ID をPOSTリクエストの本文に含める必要があります。 この操作により、特定のデータセットのすべてのデータが削除されます。レコ Experience Platform ドと時系列の両方のスキーマに基づいてデータセットを削除できます。

API 形式

POST /system/jobs

リクエスト

IMPORTANT
次のリクエストは、Azure インスタンスとAWS インスタンスで異なります。
Microsoft Azure
accordion
データセットを削除するリクエストのサンプル。
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": "5c802d3cd83fc114b741c4b5"
      }'
table 0-row-2 1-row-2
プロパティ 説明
dataSetId 削除するデータセットの ID。
Amazon Web Services(AWS)
note important
IMPORTANT
このエンドポイントをAWSで使用する場合は x-sandbox-name リクエストヘッダーではなく x-sandbox-id リクエストヘッダーを使用する 必要があります)。
accordion
データセットを削除するリクエストのサンプル。
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-id: {SANDBOX_ID}' \
  -d '{
        "dataSetId": "5c802d3cd83fc114b741c4b5"
      }'
table 0-row-2 1-row-2
プロパティ 説明
dataSetId 削除するデータセットの ID。

応答

IMPORTANT
次の応答は、Azure インスタンスとAWS インスタンスで異なります。
Microsoft Azure

正常な応答は、新しく作成された削除リクエストの詳細を返します。この詳細には、システムで生成された一意の読み取り専用 ID が含まれます。これは、リクエストを検索し、そのステータスを確認するために使用できます。作成時のリクエストの status は、処理が開始されるまで "NEW" です。応答内の dataSetId は、リクエストで送信された dataSetId と一致する必要があります。

accordion
削除リクエストの作成に成功した応答。
code language-json
{
    "id": "3f225e7e-ac8c-4904-b1d5-0ce79e03c2ec",
    "imsOrgId": "{ORG_ID}",
    "dataSetId": "5c802d3cd83fc114b741c4b5",
    "jobType": "DELETE",
    "status": "NEW",
    "createEpoch": 1559025404,
    "updateEpoch": 1559025406
}
table 0-row-2 1-row-2 2-row-2
プロパティ 説明
id システムによって生成された、削除リクエストの一意の読み取り専用 ID。
dataSetId POST リクエストで指定されたデータセットの ID。
Amazon Web Services(AWS)

応答が成功すると、新しく作成したシステムリクエストの詳細が返されます。

accordion
削除リクエストの作成に成功した応答。
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": "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_TTLDELETE_EE_BATCHTRUNCATE_DATASET です。
status システムジョブのステータス。 使用可能な値は、NEWSUCCESSERRORFAILEDIN-PROGRESS などです。
properties システムジョブのバッチ ID やデータセット ID を含むオブジェクト。

バッチの削除

バッチを削除するには、バッチ ID を POST リクエストの本文に含める必要があります。レコードスキーマに基づくデータセットのバッチは削除できません。時系列スキーマに基づくデータセットのバッチのみが削除できます。

NOTE
レコードスキーマに基づくデータセットのバッチを削除できないのは、レコードタイプのデータセットバッチが以前のレコードを上書きするため、「取り消し」または削除できないためです。レコードスキーマに基づくデータセットに対して誤ったバッチの影響を削除する唯一の方法は、間違ったレコードを上書きするために、正しいデータでバッチを再度取り込むことです。

レコードと時系列の動作について詳しくは、XDM System の概要の XDM データの動作に関する節を参照してください。

API 形式

POST /system/jobs

リクエスト

IMPORTANT
次のリクエストは、Azure インスタンスとAWS インスタンスで異なります。
Microsoft Azure
accordion
バッチを削除するリクエストのサンプル。
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": "8d075b5a178e48389126b9289dcfd0ac"
      }'
table 0-row-2 1-row-2 2-row-2
プロパティ 説明
datasetId 削除するバッチのデータセットの ID。
batchId 削除するバッチの ID。
Amazon Web Services(AWS)
note important
IMPORTANT
このエンドポイントをAWSで使用する場合は x-sandbox-name リクエストヘッダーではなく x-sandbox-id リクエストヘッダーを使用する 必要があります)。
accordion
バッチを削除するリクエストのサンプル。
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-id: {SANDBOX_ID}' \
  -d '{
        "datasetId": "66a92c5910df2d1767de13f3",
        "batchId": "8d075b5a178e48389126b9289dcfd0ac"
      }'
table 0-row-2 1-row-2 2-row-2
プロパティ 説明
datasetId 削除するバッチのデータセットの ID。
batchId 削除するバッチの ID。

応答

IMPORTANT
次の応答は、Azure インスタンスとAWS インスタンスで異なります。
Microsoft Azure

正常な応答は、新しく作成された削除リクエストの詳細を返します。この詳細には、システムで生成された一意の読み取り専用 ID が含まれます。これは、リクエストを検索し、そのステータスを確認するために使用できます。作成時のリクエストの "status" は、処理が開始されるまで "NEW" です。応答の "batchId" 値は、リクエストで送信された "batchId" 値と一致する必要があります。

accordion
削除リクエストの作成に成功した応答。
code language-json
{
    "id": "9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4",
    "imsOrgId": "{ORG_ID}",
    "datasetId": "66a92c5910df2d1767de13f3",
    "batchId": "8d075b5a178e48389126b9289dcfd0ac",
    "jobType": "DELETE",
    "status": "NEW",
    "createEpoch": 1559026131,
    "updateEpoch": 1559026132
}
table 0-row-2 1-row-2 2-row-2 3-row-2
プロパティ 説明
id システムによって生成された、削除リクエストの一意の読み取り専用 ID。
datasetId 指定したデータセットの ID。
batchId POST リクエストで指定されたバッチの ID。
Amazon Web Services(AWS)

応答が成功すると、新しく作成したシステムリクエストの詳細が返されます。

accordion
削除リクエストの作成に成功した応答。
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": "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_TTLDELETE_EE_BATCHTRUNCATE_DATASET です。
status システムジョブのステータス。 使用可能な値は、NEWSUCCESSERRORFAILEDIN-PROGRESS などです。
properties システムジョブのバッチ ID やデータセット ID を含むオブジェクト。
AVAILABILITY
Microsoft Azure で Platform を使用している場合、次の機能は のみ 使用できます。

レコードデータセットバッチの削除リクエストを開始しようとすると、次のような 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

特定の削除リクエスト(ステータスなどの詳細を含む)を表示するには、/system/jobs エンドポイントに対してルックアップ(GET)リクエストを実行し、削除リクエストの ID をパスに含めることができます。

API 形式

GET /system/jobs/{DELETE_REQUEST_ID}
パラメーター
説明
{DELETE_REQUEST_ID}
表示する削除リクエストの ID。

リクエスト

IMPORTANT
次のリクエストは、Azure インスタンスとAWS インスタンスで異なります。
Microsoft Azure
accordion
プロファイルジョブを表示するリクエストのサンプル。
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}'
Amazon Web Services(AWS)
note important
IMPORTANT
このエンドポイントをAWSで使用する場合は x-sandbox-name リクエストヘッダーではなく x-sandbox-id リクエストヘッダーを使用する 必要があります)。
accordion
プロファイルジョブを表示するリクエストのサンプル。
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-id: {SANDBOX_ID}'

応答

IMPORTANT
次の応答は、Azure インスタンスとAWS インスタンスで異なります。
Microsoft Azure

応答には、更新されたステータスを含む、削除リクエストの詳細が表示されます。応答内の削除リクエストの ID ("id" 値)は、リクエストパスで送信された ID と一致する必要があります。

accordion
削除リクエストの表示に成功した応答。
code language-json
{
    "id": "9c2018e2-cd04-46a4-b38e-89ef7b1fcdf4",
    "imsOrgId": "{ORG_ID}",
    "batchId": "8d075b5a178e48389126b9289dcfd0ac",
    "jobType": "DELETE",
    "status": "COMPLETED",
    "metrics": "{\"recordsProcessed\":5,\"timeTakenInSec\":1}",
    "createEpoch": 1559026134,
    "updateEpoch": 1559026137
}
table 0-row-2 1-row-2 2-row-2 3-row-2
プロパティ 説明
jobType 作成されるジョブのタイプ。この場合、常に "DELETE" を返します。
status 削除リクエストのステータス。使用可能な値は、NEWPROCESSINGCOMPLETEDERROR などです。
metrics 処理されたレコードの数("recordsProcessed")、リクエストが処理された時間(秒)、またはリクエストが完了するまでにかかった時間("timeTakenInSec")を含む配列。
Amazon Web Services(AWS)

応答が成功すると、指定されたシステムリクエストの詳細が返されます。

accordion
削除リクエストの表示に成功した応答。
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_TTLDELETE_EE_BATCHTRUNCATE_DATASET です。
status システムジョブのステータス。 使用可能な値は、NEWSUCCESSERRORFAILEDIN-PROGRESS などです。
properties システムジョブのバッチ ID やデータセット ID を含むオブジェクト。

削除リクエストステータスが "COMPLETED" になると、Data Access API を使用して削除されたデータにアクセスすることで、データが削除されたことを確認できます。 データアクセス API を使用してデータセットやバッチにアクセスする手順については、データアクセスのドキュメントを参照してください。

削除リクエストの削除

AVAILABILITY
このエンドポイントは、Adobe Experience Platformの Azure インスタンスで のみ サポートされており、AWS インスタンスでは サポートされていません

以前のリクエストを削除で Experience Platform ます。削除ジョブが完了しなかった場合や、処理ステージで停止した場合など、様々な理由で役立つ場合があります。 削除リクエストを削除するには、/system/jobs エンドポイントに対して DELETE リクエストを実行し、削除する削除リクエストの ID をリクエストパスに含めます。

API 形式

DELETE /system/jobs/{DELETE_REQUEST_ID}
パラメーター
説明
削除する削除リクエストの 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)と空の応答本文が返されます。GET リクエストを実行して ID で削除リクエストを表示すると、リクエストが削除されたことを確認できます。削除リクエストが削除されたことを示す HTTP ステータス 404(不検知)が返されます。

次の手順

Experience Platform 内の Profile store からデータセットとバッチを削除する手順がわかったので、誤って追加されたデータや、組織が必要としなくなったデータを安全に削除できます。 削除リクエストは元に戻せないので、今は不要で将来は不要になると確信しているデータのみを削除するようにしてください。

recommendation-more-help
54550d5b-f1a1-4065-a394-eb0f23a2c38b