本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 PATCH 操作修改資源

AWS HealthLake 支援 FHIR 資源的 PATCH 操作，可讓您透過鎖定要新增、取代或刪除的特定元素來修改資源，而無需更新整個資源。當您需要執行下列動作時，此操作特別有用：

支援的修補程式格式

AWS HealthLake 支援兩種標準 PATCH 格式：

JSON 修補程式 (RFC 6902)

使用 JSON 指標語法，依其在資源結構中的位置來鎖定元素。

Content-Type： application/json-patch+json

FHIRPath 修補程式 (FHIR R4 規格）

使用 FHIRPath 表達式，依其內容和關係來鎖定元素，提供 FHIR 原生的修補方法。

Content-Type： application/fhir+json

Usage

直接修補操作

您可以使用 PATCH HTTP 方法，直接在 FHIR 資源上叫用 PATCH 操作：

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

套件中的 PATCH

PATCH 操作可以包含在類型 batch或 的 FHIR 套件中作為項目transaction，讓您能夠在單一請求中將修補程式操作與其他 FHIR 互動 （建立、讀取、更新、刪除） 結合。

JSON 修補程式格式

受支援的 操作

路徑語法

JSON 修補程式使用 JSON 指標語法 (RFC 6901)：

範例

具有多個操作的直接 JSON 修補程式請求

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

使用單一操作的直接 JSON 修補程式請求

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

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

套件中的 JSON 修補程式

使用包含 base64 編碼 JSON 修補程式承載的二進位資源：

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

FHIRPath 修補程式格式

受支援的 操作

路徑語法

FHIRPath 修補程式使用 FHIRPath 表達式，支援：

範例

Direct 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 修補程式

透過 使用參數資源做為項目資源method: 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"
    }
  }]
}

請求標頭

回應範例

操作會傳回具有新版本資訊的更新資源：

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 (行為)

PATCH 操作：

錯誤處理

操作會處理下列錯誤條件：

功能摘要

限制

其他資源

如需 PATCH 操作的詳細資訊，請參閱：