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

# 使用 刪除資源類型 `$bulk-delete`
<a name="reference-fhir-operations-bulk-delete"></a>

AWS HealthLake 支援 `$bulk-delete`操作，可刪除資料存放區中特定類型的所有資源。當您需要：
+ 執行季節性稽核和清除
+ 大規模管理資料生命週期
+ 移除特定資源類型
+ 遵循資料保留政策

## Usage
<a name="bulk-delete-usage"></a>

您可以使用 POST 方法叫用 `$bulk-delete`操作：

```
POST [base]/[ResourceType]/$bulk-delete?isHardDelete=false&deleteAuditEvent=true
```

## Parameters
<a name="bulk-delete-parameters"></a>


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

## 範例
<a name="bulk-delete-examples"></a>

**範例請求**  


```
POST [base]/Observation/$bulk-delete?isHardDelete=false
```

**回應範例**  


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

## 任務狀態
<a name="bulk-delete-job-status"></a>

若要檢查大量刪除任務的狀態：

```
GET [base]/$bulk-delete/[jobId]
```

操作會傳回任務狀態資訊：

```
{
      "datastoreId": "datastoreId",
      "jobId": "jobId",
      "status": "COMPLETED",
      "submittedTime": "2025-10-09T15:09:51.336Z"
    }
```

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

`$bulk-delete` 操作：

1. 以非同步方式處理大量資源

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

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

1. 支援軟式和硬式刪除模式

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

1. 允許選擇性刪除歷史版本和稽核事件

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

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

## 限制
<a name="bulk-delete-limitations"></a>
+ 當 `isHardDelete` 設為 true 時，硬刪除的資源不會出現在搜尋結果或`_history`查詢中。
+ 透過此操作刪除的資源在處理期間可能暫時無法存取
+ 僅根據歷史版本調整儲存計量 - deleteVersionHistory=false 不會調整資料存放區儲存