翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# を使用してリソースを完全に削除する `$erase`
<a name="reference-fhir-operations-erase"></a>

AWS HealthLake は `$erase`オペレーションをサポートし、特定のリソースとその履歴バージョンを完全に削除できます。このオペレーションは、以下が必要な場合に特に役立ちます。
+ 個々のリソースを完全に削除する
+ 特定のバージョン履歴を削除する
+ 個々のリソースライフサイクルを管理する
+ 特定のデータ削除要件に準拠する

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

`$erase` オペレーションは 2 つのレベルで呼び出すことができます。

**リソースインスタンスレベル**  


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

**バージョン固有のレベル**  


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

## パラメータ
<a name="erase-parameters"></a>


| パラメータ | タイプ | [Required] (必須) | デフォルト | 説明  | 
| --- | --- | --- | --- | --- | 
| deleteAuditEvent | boolean | 不可 | 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` オペレーションは、ユーザー ID、タイムスタンプ、リソースの詳細とともに DeleteResource としてログに記録します。

## 制限事項
<a name="erase-limitations"></a>
+ `$erased` リソースは検索結果や`_history`クエリに表示されません。
+ 消去されるリソースは、処理中に一時的にアクセスできない場合があります。
+ リソースが完全に削除されるとすぐにストレージ計測が調整されます