APIでのオブジェクトの削除

DELETEリクエストのパスにCatalogオブジェクトのIDを指定すると、オブジェクトを削除できます。

警告

オブジェクトの削除は取り消しができず、Experience Platformの他の場所で改行の変更が行われる可能性があるので、注意が必要です。

API 形式

DELETE /{OBJECT_TYPE}/{OBJECT_ID}
重要

DELETE /batches/{ID}エンドポイントは非推奨です。 バッチを削除するには、バッチ取り込みAPIを使用する必要があります。

パラメーター 説明
{OBJECT_TYPE} 削除するCatalogオブジェクトの種類です。 有効なオブジェクトは次のとおりです。
  • accounts
  • connections
  • dataSets
  • dataSetFiles
  • dataSetViews
{OBJECT_ID} 更新する特定のオブジェクトの識別子。

リクエスト

次のリクエストを実行すると、リクエストパスで ID が指定されたデータセットが削除されます。

curl -X DELETE \
  'https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

リクエストが成功した場合は、削除したデータセットの ID を含む配列と HTTP ステータス 200(OK)が返されます。この ID は、DELETE リクエストで送信された ID と一致します。削除したオブジェクトに対して GET リクエストを実行すると、HTTP ステータス 404(Not Found)が返され、データセットが正常に削除されたことがわかります。

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]
メモ

リクエストで指定されたIDに一致するCatalogオブジェクトがない場合、HTTPステータスコード200を引き続き受け取ることができますが、応答配列は空になります。

このページ