Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Suppression permanente de ressources avec `$erase`
<a name="reference-fhir-operations-erase"></a>

AWS HealthLake prend en charge l'`$erase`opération, permettant la suppression permanente d'une ressource spécifique et de ses versions historiques. Cette opération est particulièrement utile lorsque vous devez :
+ Supprimer définitivement des ressources individuelles
+ Supprimer des historiques de versions spécifiques
+ Gérez le cycle de vie des ressources individuelles
+ Respectez les exigences spécifiques en matière de suppression des données

## Usage
<a name="erase-usage"></a>

L'`$erase`opération peut être invoquée à deux niveaux :

**Niveau de l'instance de ressource**  


```
POST [base]/[ResourceType]/[ID]/$erase?deleteAuditEvent=true
```

**Niveau spécifique à la version**  


```
POST [base]/[ResourceType]/[ID]/_history/[VersionID]/$erase
```

## Parameters
<a name="erase-parameters"></a>


| Paramètre | Type | Obligatoire | Par défaut | Description | 
| --- | --- | --- | --- | --- | 
| deleteAuditEvent | booléen | Non | false | Lorsque c'est vrai, supprime les événements d'audit associés | 

## Exemples
<a name="erase-examples"></a>

**Exemple de requête**  


```
POST [base]/Patient/example-patient/$erase
```

**Exemple de réponse**  


```
{
      "jobId": "5df47e2f51ff3c731847678cb8cad48e",
      "jobStatus": "SUBMITTED"
    }
```

## Statut de la tâche
<a name="erase-job-status"></a>

Pour vérifier le statut d'une tâche d'effacement :

```
GET [base]/$erase/[jobId]
```

L'opération renvoie les informations relatives à l'état de la tâche :

```
{
      "datastoreId": "36622996b1fcecb7e12ee2ee085308d3",
      "jobId": "5df47e2f51ff3c731847678cb8cad48e",
      "status": "COMPLETED",
      "submittedTime": "2025-10-30T16:39:24.160Z"
    }
```

## Comportement
<a name="erase-behavior"></a>

L'`$erase`opération :

1. Traite de manière asynchrone pour garantir l'intégrité des données

1. Maintient les transactions ACID

1. Assure le suivi de l'état des tâches

1. Supprime définitivement la ressource spécifiée et ses versions

1. Inclut un enregistrement d'audit complet des activités de suppression

1. Supporte la suppression sélective des événements d'audit

## Journalisation des audits
<a name="erase-audit-logging"></a>

L'`$erase`opération est enregistrée sous forme DeleteResource d'ID utilisateur, d'horodatage et de détails sur les ressources.

## Limitations
<a name="erase-limitations"></a>
+ `$erased`la ressource n'apparaîtra pas dans les résultats de recherche ou `_history` les requêtes.
+ Les ressources en cours d'effacement peuvent être temporairement inaccessibles pendant le traitement
+ La mesure du stockage est ajustée immédiatement lorsque les ressources sont définitivement supprimées