Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Skaliertes Patchen von Ressourcen mit $bulk-patch

AWS HealthLake unterstützt den $bulk-patch Vorgang zum asynchronen Anwenden von Patch-Vorgängen auf eine große Anzahl von FHIR-Ressourcen. Sie können eine bestimmte Liste von Ressourcen nach ID oder alle Ressourcen eines bestimmten Typs innerhalb eines Datenspeichers als Ziel auswählen. Mit diesem Vorgang können Sie Ressourcen in großem Umfang ändern, ohne jede Ressource einzeln aktualisieren zu müssen.

Die $bulk-patch Operation ist besonders nützlich, wenn Sie Folgendes tun müssen:

Usage

Der $bulk-patch Vorgang ist asynchron. Um einen Job zu starten, senden Sie eine POST-Anfrage:

POST [base]/$bulk-patch

Verwenden Sie den Describe-Endpunkt, um den Status eines Jobs abzufragen:

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

Gehen Sie wie folgt vor, um mit dem $bulk-patch Vorgang zu beginnen:

Parameters

Der $bulk-patch Vorgang unterstützt die folgenden Parameter.

Ressourcen ins Visier nehmen

Sie können Ressourcen in zwei Modi gezielt einsetzen.

Modus „Ressourcentyp“

Im Ressourcentypmodus patcht der Vorgang alle Ressourcen eines bestimmten Typs im Datenspeicher.

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

Modus „Ressourcen-IDs“

Im Modus „Ressourcen-IDs“ patcht der Vorgang eine bestimmte Liste von Ressourcen nach ID. Alle Ressourcen-IDs müssen vom gleichen Typ sein und mit dem resourceType Parameter übereinstimmen. Das Format kann eine vollständige Referenz ([resourceType]/[id]) oder nur die ID ([id]) sein. Die Liste kann bis zu 50.000 Ressourcen-IDs enthalten.

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

Unterstützte Patch-Formate

Die $bulk-patch Operation unterstützt sowohl die JSON Patch (RFC 6902) als auch die FHIR Patch (FHIRPath-based) -Syntax. Sie verwendet dieselben unterstützten Operationen und dieselbe Syntax wie die synchrone PATCH-Operation. Weitere Informationen finden Sie unter Ändern von Ressourcen mit PATCH-Operation.

Beispiel für einen Bulk-Patch-Job starten

Im folgenden Beispiel wird ein Bulk-Patch-Auftrag übermittelt, der mithilfe von FHIR Patch bestimmten Patient Ressourcen ein Compliance-Tag hinzufügt.

Beispielanforderung

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"
                    }}
                ]
            }
        ]
    }
}

Beispielantwort

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

Statusabfrage für Bulk-Patch-Jobs

Nachdem Sie einen Auftrag eingereicht haben, fragen Sie den Auftragsstatus ab, um den Fortschritt zu verfolgen und Ergebnisse abzurufen. Der Job wechselt über SUBMITTED IN_PROGRESS und dann in den Endzustand COMPLETED oderCOMPLETED_WITH_ERRORS.

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

Das folgende Beispiel zeigt eine Antwort für einen Job, der gerade ausgeführt wird.

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

Wenn der Job den Endzustand erreicht, enthält die Describe-Antwort eine Zusammenfassung der Anzahl erfolgreicher, fehlgeschlagener und übersprungener Ressourcen. Wenn Ressourcen ausgefallen sind oder übersprungen wurden, werden in der Antwort die Gründe in failedResources und aufgeführt. skippedResources Der Auftragsstatus wird angezeigt, COMPLETED_WITH_ERRORS wenn ein Fehler aufgetreten ist, unabhängig davon, ob es sich um einen Kundenfehler oder einen Serverfehler handelt. Durch die Größe der Antwort sind die skippedResources Listen failedResources und begrenzt, sodass sie möglicherweise gekürzt werden. Prüfen Sie failedResourcesTruncated und skippedResourcesTruncated stellen Sie fest, ob die vollständige Liste enthalten ist.

{
    "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
}

Häufige Gründe für übersprungene Auslassungen

Bei dem Vorgang wird eine Ressource übersprungen, wenn sie im Gültigkeitsbereich ist, aber sie kann nicht gepatcht werden, da sich ihr Status zwischen Auftragsübergabe und Verarbeitung geändert hat. Übersprungene Ressourcen werden nicht als Fehler betrachtet. Im Folgenden sind häufige Gründe dafür aufgeführt, dass eine Ressource übersprungen wird.

Häufige Kundenfehler

Eine Ressource schlägt fehl, wenn der Vorgang den Patch aufgrund eines Problems mit der Ressource oder den Patch-Vorgängen nicht anwenden kann. Bei fehlgeschlagenen Ressourcen wird eine Fehlermeldung mit Diagnosedetails angezeigt. Im Folgenden sind häufige Kundenfehler aufgeführt.

Bewährte Methoden

Wir empfehlen die folgenden bewährten Methoden, wenn Sie den $bulk-patch Vorgang verwenden.

Autorisierung

Der $bulk-patch Vorgang unterstützt die folgenden Autorisierungsmethoden:

Leistungsmerkmale

Der $bulk-patch Vorgang ist für die Verarbeitung großer Datenmengen konzipiert und läuft asynchron.

Zugehörige -Vorgänge