删除API中的对象

您可以删除 Catalog 对象,方法是在DELETE请求的路径中提供其ID。

WARNING
删除对象时请格外小心,因为此操作无法撤消,并且可能会在中的其他位置产生重大更改 Experience Platform.

API格式

DELETE /{OBJECT_TYPE}/{OBJECT_ID}
IMPORTANT
DELETE /batches/{ID} 端点已被弃用。 要删除批次,您应使用 批量摄取API.
参数
描述
{OBJECT_TYPE}

类型 Catalog 要删除的对象。 有效对象为:

  • dataSets
  • dataSetFiles
{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: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

响应

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

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]
NOTE
如果否 Catalog 对象与请求中提供的ID匹配,您仍可能会收到HTTP状态代码200,但响应数组将为空。
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676