Excluir um objeto na API

É possível excluir um Catalog fornecendo a respectiva ID no caminho de uma solicitação DELETE.

WARNING
Tenha cuidado extra ao excluir objetos, pois essa ação não pode ser desfeita e pode produzir alterações de quebra em outro local no Experience Platform.

Formato da API

DELETE /{OBJECT_TYPE}/{OBJECT_ID}
IMPORTANT
A variável DELETE /batches/{ID} O ponto de extremidade foi descontinuado. Para excluir um lote, você deve usar o API de assimilação em lote.
Parâmetro
Descrição
{OBJECT_TYPE}

O tipo de Catalog objeto a ser excluído. Os objetos válidos são:

  • dataSets
  • dataSetFiles
{OBJECT_ID}
O identificador do objeto específico que você deseja atualizar.

Solicitação

A solicitação a seguir exclui um conjunto de dados cuja ID está especificada no caminho da solicitação.

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

Resposta

Uma resposta bem-sucedida retorna o status HTTP 200 (OK) e uma matriz contendo a ID do conjunto de dados excluído. Essa ID deve corresponder à enviada na solicitação DELETE. A execução de uma solicitação GET no objeto excluído retorna o status HTTP 404 (Não encontrado), confirmando que o conjunto de dados foi excluído com sucesso.

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]
NOTE
Se não Catalog Os objetos do correspondem à ID fornecida na solicitação. Você ainda poderá receber um Código de status HTTP 200, mas a matriz de resposta estará vazia.
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676