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.

Ändern von Ressourcen mit PATCH-Operation

AWS HealthLake unterstützt den PATCH-Vorgang für FHIR-Ressourcen, sodass Sie Ressourcen ändern können, indem Sie gezielt bestimmte Elemente hinzufügen, ersetzen oder löschen möchten, ohne die gesamte Ressource zu aktualisieren. Dieser Vorgang ist besonders nützlich, wenn Sie:

Unterstützte PATCH-Formate

AWS HealthLake unterstützt zwei Standard-PATCH-Formate:

JSON-Patch (RFC 6902)

Verwendet die JSON-Pointer-Syntax, um Elemente anhand ihrer Position in der Ressourcenstruktur als Ziel auszuwählen.

Inhaltstyp: application/json-patch+json

FHIRPath Patch (FHIR R4-Spezifikation)

Verwendet FHIRPath Ausdrücke, um Elemente anhand ihres Inhalts und ihrer Beziehungen gezielt anzusprechen, und bietet so einen FHIR-nativen Patchansatz.

Inhaltstyp: application/fhir+json

Usage

Direkte PATCH-Operationen

Der PATCH-Vorgang kann mit der PATCH-HTTP-Methode direkt auf FHIR-Ressourcen aufgerufen werden:

PATCH [base]/[resource-type]/[id]{?_format=[mime-type]}

PATCH in Paketen

PATCH-Operationen können als Einträge in FHIR-Bundles des Typs enthalten sein batch oder ermöglichen es Ihnentransaction, Patch-Operationen mit anderen FHIR-Interaktionen (Erstellen, Lesen, Aktualisieren, Löschen) in einer einzigen Anfrage zu kombinieren.

JSON-Patch-Format

Unterstützte Vorgänge

Pfadsyntax

Der JSON-Patch verwendet die JSON-Pointer-Syntax (RFC 6901):

Beispiele

Direkte JSON-Patch-Anfrage mit mehreren Vorgängen

PATCH [base]/Patient/example
Content-Type: application/json-patch+json
If-Match: W/"1"

[
  {
    "op": "replace",
    "path": "/name/0/family",
    "value": "Smith"
  },
  {
    "op": "add",
    "path": "/telecom/-",
    "value": {
      "system": "phone",
      "value": "555-555-5555",
      "use": "home"
    }
  },
  {
    "op": "remove",
    "path": "/address/0"
  },
  {
    "op": "move",
    "from": "/name/0/family",
    "path": "/name/1/family"
  },
  {
    "op": "test",
    "path": "/gender",
    "value": "male"
  },
  {
    "op": "copy",
    "from": "/name/0",
    "path": "/name/1"
  }
]

Direkte JSON-Patch-Anfrage mit einem einzigen Vorgang

PATCH [base]/Patient/example
Content-Type: application/json-patch+json

[
  {
    "op": "replace",
    "path": "/active",
    "value": false
  }
]

JSON-Patch im Paket

Verwenden Sie eine Binärressource, die die Base64-kodierte JSON-Patch-Payload enthält:

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [{
    "resource": {
      "resourceType": "Binary",
      "contentType": "application/json-patch+json",
      "data": "W3sib3AiOiJhZGQiLCJwYXRoIjoiL2JpcnRoRGF0ZSIsInZhbHVlIjoiMTk5MC0wMS0wMSJ9XQ=="
    },
    "request": {
      "method": "PATCH",
      "url": "Patient/123"
    }
  }]
}

FHIRPath Patch-Format

Unterstützte Vorgänge

Pfadsyntax

FHIRPath Patch verwendet FHIRPath Ausdrücke und unterstützt:

Beispiele

Direkte Patch-Anfrage FHIRPath

PATCH [base]/Patient/123
Content-Type: application/fhir+json
Authorization: ...

{
  "resourceType": "Parameters",
  "parameter": [{
    "name": "operation",
    "part": [
      { "name": "type", "valueCode": "add" },
      { "name": "path", "valueString": "Patient" },
      { "name": "name", "valueString": "birthDate" },
      { "name": "value", "valueDate": "1990-01-01" }
    ]
  }]
}

FHIRPath Patch im Paket

Verwenden Sie eine Parameter-Ressource als Eingangsressource mitmethod: PATCH:

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [{
    "resource": {
      "resourceType": "Parameters",
      "parameter": [{
        "name": "operation",
        "part": [
          { "name": "type", "valueCode": "add" },
          { "name": "path", "valueString": "Patient" },
          { "name": "name", "valueString": "birthDate" },
          { "name": "value", "valueDate": "1990-01-01" }
        ]
      }]
    },
    "request": {
      "method": "PATCH",
      "url": "Patient/123"
    }
  }]
}

Anforderungsheader

Beispielantwort

Der Vorgang gibt die aktualisierte Ressource mit neuen Versionsinformationen zurück:

HTTP/1.1 200 OK
Content-Type: application/fhir+json
ETag: W/"2"
Last-Modified: Mon, 05 May 2025 10:10:10 GMT

{
  "resourceType": "Patient",
  "id": "example",
  "active": true,
  "name": [
    {
      "family": "Smith",
      "given": ["John"]
    }
  ],
  "telecom": [
    {
      "system": "phone",
      "value": "555-555-5555",
      "use": "home"
    }
  ],
  "meta": {
    "versionId": "2",
    "lastUpdated": "2025-05-05T10:10:10Z"
  }
}

Behavior

Die PATCH-Operation:

Fehlerbehandlung

Der Vorgang behandelt die folgenden Fehlerbedingungen:

Zusammenfassung der Funktionen

Einschränkungen

Weitere Ressourcen

Weitere Informationen zu PATCH-Vorgängen finden Sie unter: