删除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}'

响应

成功的响应会返回HTTP状态200(OK)和包含已删除数据集ID的数组。 此ID应与在DELETE请求中发送的ID匹配。 对已删除的对象执行GET请求将返回HTTP状态404(未找到),确认已成功删除数据集。

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]
注意

如果没有与请求中提供的ID匹配的Catalog对象,您仍可能收到HTTP状态代码200,但响应数组将为空。

在此页面上