

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用永久删除资源 `$erase`
<a name="reference-fhir-operations-erase"></a>

AWS HealthLake 支持该`$erase`操作，允许永久删除特定资源及其历史版本。当您需要执行以下操作时，此操作特别有用：
+ 永久移除个别资源
+ 删除特定的版本历史记录
+ 管理单个资源生命周期
+ 遵守特定的数据删除要求

## 用法
<a name="erase-usage"></a>

可以在两个级别上调用该`$erase`操作：

**资源实例级别**  


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

**特定版本级别**  


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

## 参数
<a name="erase-parameters"></a>


| 参数 | Type | 必需 | 默认值 | 说明 | 
| --- | --- | --- | --- | --- | 
| deleteAuditEvent | 布尔值 | 否 | false | 如果为 true，则删除关联的审计事件 | 

## 示例
<a name="erase-examples"></a>

**请求示例**  


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

**响应示例**  


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

## 作业状态
<a name="erase-job-status"></a>

要检查擦除作业的状态，请执行以下操作：

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

该操作返回任务状态信息：

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

## 行为
<a name="erase-behavior"></a>

该`$erase`操作：

1. 异步处理以确保数据完整性

1. 维护 ACID 交易

1. 提供作业状态跟踪

1. 永久移除指定资源及其版本

1. 包括删除活动的全面审核记录

1. 支持选择性删除审计事件

## 审核日志
<a name="erase-audit-logging"></a>

`$erase`操作记录 DeleteResource 与用户 ID、时间戳和资源详细信息相同。

## 限制
<a name="erase-limitations"></a>
+ `$erased`资源不会出现在搜索结果或`_history`查询中。
+ 正在删除的资源在处理过程中可能暂时无法访问
+ 资源被永久删除后，存储计量会立即调整