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

を使用して大規模なリソースにパッチを適用する $bulk-patch

AWS HealthLake は、多数の FHIR リソースに非同期的にパッチオペレーションを適用するための $bulk-patch オペレーションをサポートしています。ID またはデータストア内の特定のタイプのすべてのリソースで、特定のリソースのリストをターゲットにできます。このオペレーションでは、各リソースを個別に更新することなく、大規模なリソースを変更できます。

$bulk-patch オペレーションは、以下を実行する必要がある場合に特に便利です。

使用方法

$bulk-patch オペレーションは非同期です。ジョブを開始するには、POST リクエストを送信します。

POST [base]/$bulk-patch

ジョブのステータスをポーリングするには、describe エンドポイントを使用します。

GET [base]/$bulk-patch/{jobId}

$bulk-patch オペレーションを開始するには、以下を実行します。

パラメータ

$bulk-patch オペレーションでは、次のパラメータがサポートされています。

リソースのターゲット設定

リソースは 2 つのモードでターゲットにできます。

リソースタイプモード

リソースタイプモードでは、オペレーションはデータストア内の特定のタイプのすべてのリソースにパッチを適用します。

{
    "resourceType": "Patient",
    "operations": { ... }
}

リソース IDs モード

リソース IDsモードでは、オペレーションは ID でリソースの特定のリストにパッチを適用します。すべてのリソース IDsは同じタイプで、 resourceTypeパラメータと一致する必要があります。形式は、フルリファレンス ([resourceType]/[id]) または ID () のみにすることができます[id]。リストには、最大 50,000 IDs を含めることができます。

{
    "resourceType": "Patient",
    "resourceIds": ["Patient/001", "Patient/002", "Patient/003"],
    "operations": { ... }
}

サポートされているパッチ形式

$bulk-patch オペレーションは、JSON パッチ (RFC 6902) と FHIR パッチ (FHIRPath ベース) の両方の構文をサポートしています。サポートされているオペレーションと同じセットと、同期 PATCH オペレーションと同じ構文を使用します。詳細については、「PATCH オペレーションによるリソースの変更」を参照してください。

一括パッチジョブを開始する例

次の の例では、FHIR Patch を使用して特定のPatientリソースにコンプライアンスタグを追加する一括パッチジョブを送信します。

リクエストの例

POST [base]/$bulk-patch
Content-Type: application/json

{
    "resourceType": "Patient",
    "resourceIds": ["patient-1", "patient-2", "patient-3"],
    "validationLevel": "strict",
    "clientToken": "unique-idempotency-token-123",
    "operations": {
        "resourceType": "Parameters",
        "parameter": [
            {
                "name": "operation",
                "part": [
                    {"name": "type", "valueCode": "add"},
                    {"name": "path", "valueString": "Patient.meta"},
                    {"name": "name", "valueString": "tag"},
                    {"name": "value", "valueCoding": {
                        "system": "http://example.org/compliance",
                        "code": "2026-audit-complete"
                    }}
                ]
            }
        ]
    }
}

レスポンスの例

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

一括パッチジョブステータスポーリング

ジョブを送信したら、ジョブのステータスをポーリングして進行状況を追跡し、結果を取得します。ジョブは SUBMITTEDと を経由しIN_PROGRESS、終了状態は COMPLETEDまたは に移行しますCOMPLETED_WITH_ERRORS。

GET [base]/$bulk-patch/{jobId}

次の例は、進行中のジョブのレスポンスを示しています。

{
    "datastoreId": "datastoreId",
    "jobId": "jobId",
    "status": "IN_PROGRESS",
    "submittedTime": "2026-09-14T06:53:31.429Z",
    "summary": {
        "estimatedResourceCount": 1000
    }
}

ジョブが終了状態になると、describe レスポンスには、成功、失敗、スキップされたリソースの数の概要が含まれます。リソースが失敗またはスキップされた場合、レスポンスには failedResourcesおよび の理由が一覧表示されますskippedResources。ジョブのステータスは、顧客エラーかサーバーエラーかにかかわらず、障害COMPLETED_WITH_ERRORSが発生した場合に になります。レスポンスサイズは failedResourcesおよび skippedResourcesリストを制限するため、切り捨てられる可能性があります。failedResourcesTruncated と をチェックskippedResourcesTruncatedして、完全なリストが含まれているかどうかを確認します。

{
    "datastoreId": "datastoreId",
    "jobId": "jobId",
    "status": "COMPLETED_WITH_ERRORS",
    "submittedTime": "2026-09-14T06:53:31.429Z",
    "endTime": "2026-09-14T07:08:34.930Z",
    "summary": {
        "estimatedResourceCount": 1000,
        "totalResourcesProcessed": 1000,
        "succeeded": 985,
        "failedWithCustomerError": 5,
        "failedWithServerError": 0,
        "skipped": 10
    },
    "failedResources": [
        {
            "resourceId": "Patient/patient-101",
            "message": "FHIR resource in payload failed FHIR validation rules."
        }
    ],
    "skippedResources": [
        {
            "resourceId": "Patient/patient-201",
            "message": "Resource was modified after job submission"
        },
        {
            "resourceId": "Patient/patient-202",
            "message": "Resource was deleted."
        },
        {
            "resourceId": "Patient/patient-203",
            "message": "Resource not found."
        }
    ],
    "failedResourcesTruncated": false,
    "skippedResourcesTruncated": false
}

スキップされる一般的な理由

オペレーションは、範囲内にあるリソースをスキップしますが、ジョブの送信と処理の間で状態が変更されたため、リソースにパッチを適用できません。スキップされたリソースはエラーとは見なされません。以下は、リソースがスキップされる一般的な理由です。

一般的な顧客障害

リソースまたはパッチオペレーションに問題があるため、オペレーションがパッチを適用できない場合、リソースは失敗します。失敗したリソースには、診断の詳細を含むエラーメッセージが含まれます。以下は、一般的な顧客の障害です。

ベストプラクティス

$bulk-patch オペレーションを使用する場合は、次のベストプラクティスをお勧めします。

Authorization

$bulk-patch オペレーションは、次の認可方法をサポートしています。

パフォーマンス特性

$bulk-patch オペレーションは大量の処理用に設計されており、非同期的に実行されます。

関連の オペレーション