本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

AWS HealthLake 支援 `$erase`操作，可永久刪除特定資源及其歷史版本。當您需要執行下列動作時，此操作特別有用：
+ 永久移除個別資源
+ 刪除特定版本歷史記錄
+ 管理個別資源生命週期
+ 符合特定資料移除要求

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

操作`$erase`可以在兩個層級叫用：

**資源執行個體層級**  


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

**版本特定層級**  


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

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


| 參數 | Type | 必要 | 預設 | Description | 
| --- | --- | --- | --- | --- | 
| 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"
    }
```

## Behavior (行為)
<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`查詢中。
+ 正在清除的資源在處理期間可能暫時無法存取
+ 當資源永久移除時，儲存體計量會立即調整