本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 PATCH 操作修改资源

AWS HealthLake 支持 FHIR 资源的 PATCH 操作，使您能够通过将特定元素定位为添加、替换或删除来修改资源，而无需更新整个资源。当您需要执行以下操作时，此操作特别有用：

支持的补丁格式

AWS HealthLake 支持两种标准补丁格式：

JSON 补丁 (RFC 6902)

使用 JSON 指针语法按元素在资源结构中的位置来定位元素。

Content-Type: application/json-patch+json

FHIRPath 补丁（FHIR R4 规范）

使用 FHIRPath 表达式根据元素的内容和关系来定位元素，从而提供了 FHIR 原生的修补方法。

Content-Type: application/fhir+json

用法

直接补丁操作

可以使用 PATCH HTTP 方法直接在 FHIR 资源上调用 PATCH 操作：

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

捆绑包中的补丁

补丁操作可以作为类型为 FHIR Bundle 的条目包含在内transaction，batch也可以在单个请求中将补丁操作与其他 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 表达式，支持：

示例

直接申请 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"
  }
}

行为

补丁操作：

错误处理

该操作处理以下错误情况：

功能摘要

限制

其他资源

有关 PATCH 操作的更多信息，请参阅：