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

# 使用移除患者隔间资源 `$purge`
<a name="reference-fhir-operations-purge"></a>

AWS HealthLake 支持`$purge`手术，允许永久删除患者隔间内的所有资源。当您需要执行以下操作时，此操作特别有用：
+ 删除与患者相关的所有数据
+ 遵守患者数据删除请求
+ 管理患者数据生命周期
+ 执行全面的患者记录清理

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

可以在患者资源上调用该`$purge`操作：

```
POST [base]/Patient/[ID]/$purge?deleteAuditEvent=true
```

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


| 参数 | Type | 必需 | 默认值 | 说明 | 
| --- | --- | --- | --- | --- | 
| deleteAuditEvent | 布尔值 | 否 | false | 如果为 true，则删除关联的审计事件 | 
| \$1since | 字符串 | 否 | 数据存储创建时间 | 输入后，选择开始截止时间，根据资源的上次修改时间来查找资源。不能与开头或结尾一起使用 | 
| start | 字符串 | 否 | 数据存储创建时间 | 输入后，根据资源的上次修改时间选择查找资源的截止时间。可以与 end 一起使用 | 
| end | 字符串 | 否 | Job 提交时间 | 输入后，选择结束截止时间，根据资源的上次修改时间来查找资源 | 

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

**请求示例**  


```
POST [base]/Patient/example-patient/$purge?deleteAuditEvent=true
```

**响应示例**  


```
{
  "resourceType": "OperationOutcome",
  "id": "purge-job",
  "issue": [
    {
      "severity": "information",
      "code": "informational",
      "diagnostics": "Purge job started successfully. Job ID: 12345678-1234-1234-1234-123456789012"
    }
  ]
}
```

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

要检查清除任务的状态，请执行以下操作：

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

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

```
{
      "datastoreId": "36622996b1fcecb7e12ee2ee085308d3",
      "jobId": "3dd1c7a5b6c0ef8c110f566eb87e2ef9",
      "status": "COMPLETED",
      "submittedTime": "2025-10-31T18:43:21.822Z"
    }
```

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

该`$purge`操作：

1. 异步处理以处理多个资源

1. 维护 ACID 事务以确保数据完整性

1. 提供任务状态跟踪，包括资源删除次数

1. 永久移除患者隔间内的所有资源

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

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

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

`$purge`操作记录为 “开始” FHIRBulk DeleteJob 和 “描述” FHIRBulkDeleteJob ，其中包含详细的操作信息。

## 限制
<a name="purge-limitations"></a>
+ 已清除的资源不会出现在搜索响应中
+ 正在清除的资源在处理过程中可能暂时无法访问
+ 患者隔间的所有资源都将被永久移除