Excluir um objeto na API

Você pode excluir um objeto Catalog fornecendo sua ID no caminho de uma solicitação DELETE.

AVISO

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

Formato da API

DELETE /{OBJECT_TYPE}/{OBJECT_ID}
IMPORTANTE

O ponto de extremidade DELETE /batches/{ID} foi substituído. Para excluir um lote, você deve estar usando a API de assimilação de lote.

Parâmetro Descrição
{OBJECT_TYPE} O tipo de objeto Catalog 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: {IMS_ORG}' \
  -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 nenhum objeto Catalog corresponder à ID fornecida em sua solicitação, você ainda poderá receber um Código de status HTTP 200, mas a matriz de resposta estará vazia.

Nesta página