Suppression d’un objet dans l’API

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

AVERTISSEMENT

Soyez très prudent lorsque vous supprimez des objets, car vous ne pouvez pas revenir en arrière et pouvez produire des modifications avec rupture ailleurs dans Experience Platform.

Format d'API

DELETE /{OBJECT_TYPE}/{OBJECT_ID}
IMPORTANT

Le point de terminaison DELETE /batches/{ID} a été abandonné. Pour supprimer un lot, vous devez utiliser l’API d’ingestion par lots.

Paramètre Description
{OBJECT_TYPE} Type d’objet Catalog à supprimer. Les objets valides sont :
  • accounts
  • connections
  • dataSets
  • dataSetFiles
  • dataSetViews
{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: {IMS_ORG}' \
  -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"
]
REMARQUE

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.

Sur cette page