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

# 使用 移除病患室資源 `$purge`
<a name="reference-fhir-operations-purge"></a>

AWS HealthLake 支援 `$purge`操作，可永久刪除病患隔室內的所有資源。當您需要執行下列動作時，此操作特別有用：
+ 移除與病患相關聯的所有資料
+ 遵循病患資料移除請求
+ 管理病患資料生命週期
+ 執行全面的病患記錄清除

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

您可以在病患資源上叫用 `$purge`操作：

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

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


| 參數 | Type | 必要 | 預設 | Description | 
| --- | --- | --- | --- | --- | 
| deleteAuditEvent | 布林值 | 否 | false | 為 true 時， 會刪除相關聯的稽核事件 | 
| \$1since | string | 否 | 資料存放區建立時間 | 輸入時， 會根據其lastModified的時間選取開始截止時間以尋找資源。無法與開始或結束搭配使用 | 
| start | string | 否 | 資料存放區建立時間 | 輸入時， 會根據資源的lastModified時間選取截止時間來尋找資源。可與 end 搭配使用 | 
| end | string | 否 | 任務提交時間 | 輸入時， 會根據其lastModified的時間選取結束截止時間以尋找資源 | 

## 範例
<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"
    }
```

## Behavior (行為)
<a name="purge-behavior"></a>

`$purge` 操作：

1. 以非同步方式處理多個資源

1. 維護 ACID 交易的資料完整性

1. 提供具有資源刪除計數的任務狀態追蹤

1. 永久移除病患隔室中的所有資源

1. 包括刪除活動的完整稽核記錄

1. 支援選擇性刪除稽核事件

## 稽核記錄
<a name="purge-audit-logging"></a>

`$purge` 操作會記錄為 StartFHIRBulkDeleteJob 和 DescribeFHIRBulkDeleteJob，其中包含詳細的操作資訊。

## 限制
<a name="purge-limitations"></a>
+ 清除的資源不會出現在搜尋回應中
+ 正在清除的資源在處理期間可能暫時無法存取
+ 病患隔室中的所有資源都會永久移除