Excluir um objeto na API

Você pode excluir um Catalog ao fornecer a ID no caminho de uma solicitação de DELETE.

AVISO

Tenha cuidado extra ao excluir objetos, pois isso não pode ser desfeito e pode produzir alterações de quebra em outro local do Experience Platform.

Formato da API

DELETE /{OBJECT_TYPE}/{OBJECT_ID}
IMPORTANTE

O DELETE /batches/{ID} endpoint foi descontinuado. Para excluir um lote, você deve usar a variável 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:
  • accounts
  • connections
  • dataSets
  • dataSetFiles
  • dataSetViews
{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 esteja 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 do GET no objeto excluído retorna o status HTTP 404 (Não encontrado), confirmando que o conjunto de dados foi excluído com êxito.

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]
OBSERVAÇÃO

Se não Catalog objetos que correspondem à ID fornecida em sua solicitação, você ainda pode receber um Código de status HTTP 200, mas a matriz de resposta estará vazia.

Nesta página