DocumentationExperience PlatformGuide des catalogues et des jeux de données

Suppression d’un objet dans l’API

Dernière mise à jour : 16 juillet 2024
  • Rubriques :
  • Catalogue

Créé pour :

  • Développeur

Vous pouvez supprimer un objet Catalog en fournissant son identifiant dans le chemin d’accès d’une requête de DELETE.

WARNING
Soyez très prudent lors de la suppression d’objets, car cette opération ne peut pas être annulée et peut produire des modifications avec rupture ailleurs dans Experience Platform.

Format d’API

DELETE /{OBJECT_TYPE}/{OBJECT_ID}
IMPORTANT
Le point d’entrée DELETE /batches/{ID} est obsolète. Pour supprimer un lot, vous devez utiliser l’ API d’ingestion par lots.
Paramètre
Description
{OBJECT_TYPE}

Le type d’objet Catalog à supprimer. Les objets valides sont :

  • dataSets
  • dataSetFiles
{OBJECT_ID}
Identifiant de l’objet spécifique que vous souhaitez mettre à jour.

Requête

La requête suivante supprime un jeu de données dont l’identifiant est précisé dans le chemin d’accès de requête.

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

Réponse

Une réponse réussie renvoie un état HTTP 200 (OK) et un tableau contenant l’identifiant du jeu de données supprimé. Cet identifiant doit correspondre à celui envoyé dans la requête DELETE. Exécuter une requête GET sur l’objet supprimé renvoie un état HTTP 404 (introuvable), confirmant que le jeu de données a été supprimé avec succès.

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]
NOTE
Si aucun objet Catalog ne correspond à l’identifiant fourni dans votre requête, vous pouvez toujours recevoir un code d’état HTTP 200, mais le tableau de réponse sera vide.
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676