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

# を使用したリソースタイプの削除 `$bulk-delete`
<a name="reference-fhir-operations-bulk-delete"></a>

AWS HealthLake は `$bulk-delete`オペレーションをサポートし、データストア内の特定のタイプのすべてのリソースを削除できます。このオペレーションは、以下が必要な場合に特に役立ちます。
+ 季節的な監査とクリーンアップを実行する
+ 大規模なデータライフサイクルの管理
+ 特定のリソースタイプを削除する
+ データ保持ポリシーに準拠する

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

`$bulk-delete` オペレーションは POST メソッドを使用して呼び出すことができます。

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

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


| パラメータ | タイプ | [Required] (必須) | デフォルト | 説明  | 
| --- | --- | --- | --- | --- | 
| isHardDelete | boolean | 不可 | false | true の場合、ストレージからリソースを完全に削除します | 
| deleteAuditEvent | boolean | なし | true | true の場合、関連する監査イベントを削除します | 
| \$1since | string | 不可 | データストアの作成時刻 | 入力すると、開始カットオフ時間を選択して、lastModified時間に基づいてリソースを検索します。開始または終了では使用できません | 
| start | string | 不可 | データストアの作成時刻 | 入力すると、カットオフ時間を選択して、lastModified時間に基づいてリソースを検索します。末尾で使用できます | 
| 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"
    }
```

## 行動
<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 はデータストアストレージを調整しません