DocumentatieExperience PlatformHandleiding voor catalogi en gegevenssets

Een object in de API verwijderen

Laatst bijgewerkt: 16 juli 2024
  • Onderwerpen:
  • Catalogus

Gemaakt voor:

  • Ontwikkelaar

U kunt een Catalog -object verwijderen door de id ervan op te geven in het pad van een DELETE-aanvraag.

WARNING
Wees voorzichtig bij het verwijderen van objecten, omdat dit niet ongedaan kan worden gemaakt en onduidelijke wijzigingen elders in Experience Platform kan veroorzaken.

API formaat

DELETE /{OBJECT_TYPE}/{OBJECT_ID}
IMPORTANT
Het eindpunt DELETE /batches/{ID} is vervangen. Om een partij te schrappen, zou u de Ingestie API van de Partij moeten gebruiken.
Parameter
Beschrijving
{OBJECT_TYPE}

Het type Catalog -object dat moet worden verwijderd. Geldige objecten zijn:

  • dataSets
  • dataSetFiles
{OBJECT_ID}
De id van het specifieke object dat u wilt bijwerken.

Verzoek

Het volgende verzoek schrapt een dataset waarvan identiteitskaart in de verzoekweg wordt gespecificeerd.

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

Reactie

Een geslaagde reactie retourneert HTTP-status 200 (OK) en een array met de id van de verwijderde dataset. Deze id moet overeenkomen met de id die in de aanvraag voor DELETE is verzonden. Wanneer u een GET-verzoek uitvoert op het verwijderde object, wordt HTTP-status 404 (Niet gevonden) geretourneerd, waarmee wordt bevestigd dat de gegevensset is verwijderd.

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]
NOTE
Als er geen Catalog -objecten overeenkomen met de id die in uw aanvraag is opgegeven, ontvangt u mogelijk nog steeds HTTP Status Code 200, maar is de responsarray leeg.
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676