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

捆绑 FHIR 资源

FHIR Bundle 是存放 FHIR 资源集合的容器。 AWS HealthLake AWS HealthLake 支持两种具有不同处理行为的捆绑包。

Batch捆绑包独立处理每种资源。如果一个资源出现故障，其余资源仍然可以成功。每个操作都是单独处理的，即使某些操作失败，处理也会继续进行。在可以接受部分成功的情况下，使用批量捆绑包进行批量操作，例如上传多份不相关的患者记录。

Transactionbundle 以原子方式将所有资源作为一个单元处理。要么所有资源操作都成功，要么都不 AWS HealthLake 提交。当您需要保证相关资源的参照完整性时，请使用交易捆绑包，例如创建具有相关观察结果和病症的患者，其中必须将所有数据记录在一起。

您可以捆绑相同或不同类型的 FHIR 资源，它们可以混合使用 FHIR 操作，例如、create、readupdatedelete、和。patch有关更多信息，请参阅 FHIR R4 文档中的资源包。

以下是每种捆绑包类型的示例用例。

以下示例显示了具有多种资源类型和操作的事务捆绑包。

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {
      "fullUrl": "urn:uuid:4f6a30fb-cd3c-4ab6-8757-532101f72065",
      "resource": {
        "resourceType": "Patient",
        "id": "new-patient",
        "active": true,
        "name": [
          {
            "family": "Johnson",
            "given": [
              "Sarah"
            ]
          }
        ],
        "gender": "female",
        "birthDate": "1985-08-12",
        "telecom": [
          {
            "system": "phone",
            "value": "555-123-4567",
            "use": "home"
          }
        ]
      },
      "request": {
        "method": "POST",
        "url": "Patient"
      }
    },
    {
      "fullUrl": "urn:uuid:7f83f473-d8cc-4a8d-86d3-9d9876a3248b",
      "resource": {
        "resourceType": "Observation",
        "id": "blood-pressure",
        "status": "final",
        "code": {
          "coding": [
            {
              "system": "http://loinc.org",
              "code": "85354-9",
              "display": "Blood pressure panel"
            }
          ],
          "text": "Blood pressure panel"
        },
        "subject": {
          "reference": "urn:uuid:4f6a30fb-cd3c-4ab6-8757-532101f72065"
        },
        "effectiveDateTime": "2023-10-15T09:30:00Z",
        "component": [
          {
            "code": {
              "coding": [
                {
                  "system": "http://loinc.org",
                  "code": "8480-6",
                  "display": "Systolic blood pressure"
                }
              ]
            },
            "valueQuantity": {
              "value": 120,
              "unit": "mmHg",
              "system": "http://unitsofmeasure.org",
              "code": "mm[Hg]"
            }
          },
          {
            "code": {
              "coding": [
                {
                  "system": "http://loinc.org",
                  "code": "8462-4",
                  "display": "Diastolic blood pressure"
                }
              ]
            },
            "valueQuantity": {
              "value": 80,
              "unit": "mmHg",
              "system": "http://unitsofmeasure.org",
              "code": "mm[Hg]"
            }
          }
        ]
      },
      "request": {
        "method": "POST",
        "url": "Observation"
      }
    },
    {
      "resource": {
        "resourceType": "Appointment",
        "id": "appointment-123",
        "status": "booked",
        "description": "Annual physical examination",
        "start": "2023-11-15T09:00:00Z",
        "end": "2023-11-15T09:30:00Z",
        "participant": [
          {
            "actor": {
              "reference": "urn:uuid:4f6a30fb-cd3c-4ab6-8757-532101f72065"
            },
            "status": "accepted"
          }
        ]
      },
      "request": {
        "method": "PUT",
        "url": "Appointment/appointment-123"
      }
    },
    {
      "request": {
        "method": "DELETE",
        "url": "MedicationRequest/med-request-456"
      }
    }
  ]
}

将 FHIR 资源捆绑为独立实体

将 FHIR 资源捆绑为独立实体

以捆绑包 PUTs 为条件

AWS HealthLake 支持使用以下查询参数在捆绑包中进行条件更新：

当您在捆绑包 PUTs 中使用条件时，会根据现有资源 AWS HealthLake 评估查询参数，并根据匹配结果采取行动。

在以下带有条件更新的捆绑包示例中，带有 FHIR ID 的Patient资源仅在满足条件_lastUpdated=lt2025-04-20时才会476更新。

{
    "resourceType": "Bundle",
    "id": "bundle-batch",
    "meta": {
        "lastUpdated": "2014-08-18T01:43:30Z"
    },
    "type": "batch",
    "entry": [
        {
            "resource": {
                "resourceType": "Patient",
                "id": "476",
                "meta": {
                    "lastUpdated": "2022-06-03T17:53:36.724Z"
                },
                "active": true,
                "name": [
                    {
                        "use": "official",
                        "family": "Jackson",
                        "given": [
                            "Mateo",
                            "James"
                        ]
                    }
                ],
                "gender": "male",
                "birthDate": "1974-12-25"
            },
            "request": {
                "method": "PUT",
                "url": "Patient?_id=476&_lastUpdated=lt2025-04-20"
            }
        },
        {
            "resource": {
                "resourceType": "Medication",
                "id": "med0310",
                "contained": [
                    {
                        "resourceType": "Substance",
                        "id": "sub03",
                        "code": {
                            "coding": [
                                {
                                    "system": "http://snomed.info/sct",
                                    "code": "55452001",
                                    "display": "Oxycodone (substance)"
                                }
                            ]
                        }
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "http://snomed.info/sct",
                            "code": "430127000",
                            "display": "Oral Form Oxycodone (product)"
                        }
                    ]
                },
                "form": {
                    "coding": [
                        {
                            "system": "http://snomed.info/sct",
                            "code": "385055001",
                            "display": "Tablet dose form (qualifier value)"
                        }
                    ]
                },
                "ingredient": [
                    {
                        "itemReference": {
                            "reference": "#sub03"
                        },
                        "strength": {
                            "numerator": {
                                "value": 5,
                                "system": "http://unitsofmeasure.org",
                                "code": "mg"
                            },
                            "denominator": {
                                "value": 1,
                                "system": "http://terminology.hl7.org/CodeSystem/v3-orderableDrugForm",
                                "code": "TAB"
                            }
                        }
                    }
                ]
            },
            "request": {
                "method": "POST",
                "url": "Medication"
            }
        }
    ]
}

将 FHIR 资源捆绑为一个实体

将 FHIR 资源捆绑为单个实体

为捆绑包配置验证级别

捆绑 FHIR 资源时，您可以选择指定 x-amzn-healthlake-fhir-validation-level HTTP 标头来配置资源的验证级别。将为捆绑包中的所有创建和更新请求设置此验证级别。 AWS HealthLake 目前支持以下验证级别：

尽管搜索索引需要验证失败，但与最低验证级别捆绑在一起的资源仍可能会被提取到数据存储中。在这种情况下，资源将更新为包含用于记录上述故障的 Healthlake 专用扩展程序，Bundle 响应中的条目将包括以下 OperationOutcome 资源：

{
    "resourceType": "Bundle",
    "type": "batch-response",
    "timestamp": "2025-08-25T22:58:48.846287342Z",
    "entry": [
        {
            "response": {
                "status": "201",
                "location": "Patient/195abc49-ba8e-4c8b-95c2-abc88fef7544/_history/1",
                "etag": "W/\"1\"",
                "lastModified": "2025-08-25T22:58:48.801245445Z",
                "outcome": {
                    "resourceType": "OperationOutcome",
                    "issue": [
                        {
                            "severity": "error",
                            "code": "processing",
                            "details": {
                                "text": "FHIR resource in payload failed FHIR validation rules."
                            },
                            "diagnostics": "FHIR resource in payload failed FHIR validation rules."
                        }
                    ]
                }
            }
        }
    ]
}

此外，将包含以下 HTTP 响应标头，其值为 “true”：

x-amzn-healthlake-validation-issues : true

对捆绑包类型 “消息” 的支持有限

HealthLake message通过内部转换过程对 FHIR 捆绑包类型提供有限的支持。此支持专为无法在源头重新格式化消息包的场景而设计，例如从传统医院系统中摄取 ADT（入院、出院、转移）提要。

与标准邮件处理的主要区别

重要限制

消息包结构示例

{
              "resourceType": "Bundle",
              "type": "message",
              "entry": [
                {
                  "resource": {
                    "resourceType": "MessageHeader",
                    "eventCoding": {
                      "system": "http://hl7.org/fhir/us/davinci-alerts/CodeSystem/notification-event",
                      "code": "notification-admit"
                    },
                    "focus": [{"reference": "Encounter/example-id"}]
                  }
                },
                {
                  "resource": {"resourceType": "Patient", "id": "example-id"}
                },
                {
                  "resource": {"resourceType": "Encounter", "id": "example-id"}
                }
              ]
            }
            

异步捆绑交易

AWS HealthLake 支持异步Bundle类型transaction，允许您提交包含最多 500 个资源的交易。当您提交异步事务时，会将其 HealthLake 排队等候处理，并立即返回轮询网址。您可以使用此 URL 来检查状态并检索响应。这遵循 FHIR 异步捆绑包模式。

何时使用异步事务

提交异步事务

要提交异步事务，请向数据存储端点发送带有Prefer: respond-async标头的POST请求。捆绑包必须有类型transaction。异步分发包处理batch不支持类型为 bundle。

HealthLake 在提交时对捆绑包进行初始验证。如果验证成功，则 HealthLake 返回 HTTP 202 Accepted，并返回包含轮询网址的content-location响应标头。

提交异步Bundle类型 transaction

轮询交易状态

提交异步事务后，使用content-location响应标头中的轮询网址来检查交易状态。向投票 URL 发送GET请求。

向投票 URL 发送GET请求。以下示例使用curl命令行工具。

SigV4

Sigv4 授权

curl --request GET \
  'https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Transaction/transactionId' \
  --aws-sigv4 'aws:amz:region:healthlake' \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
  --header 'Accept: application/json'

SMART on FHIR

SMART 在 FHIR 授权上。授权令牌必须包含Transaction资源类型的read权限。

curl --request GET \
  'https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Transaction/transactionId' \
  --header 'Authorization: Bearer $SMART_ACCESS_TOKEN' \
  --header 'Accept: application/json'

下表描述了可能的响应。

以下示例显示了每种响应类型。

交易已排队 (202)

{
    "resourceType": "OperationOutcome",
    "id": "transactionId",
    "issue": [
        {
            "severity": "information",
            "code": "informational",
            "diagnostics": "SUBMITTED"
        }
    ]
}

交易处理 (202)

{
    "resourceType": "OperationOutcome",
    "id": "transactionId",
    "issue": [
        {
            "severity": "information",
            "code": "informational",
            "diagnostics": "IN_PROGRESS"
        }
    ]
}

交易已完成 (200)

{
    "resourceType": "Bundle",
    "type": "transaction-response",
    "entry": [
        {
            "response": {
                "status": "201",
                "location": "Patient/example-id/_history/1",
                "etag": "W/\"1\"",
                "lastModified": "2024-01-15T10:30:00.000Z"
            }
        },
        {
            "response": {
                "status": "201",
                "location": "Observation/example-id/_history/1",
                "etag": "W/\"1\"",
                "lastModified": "2024-01-15T10:30:00.000Z"
            }
        }
    ]
}

交易失败 (4xx/5xx)

{
    "resourceType": "OperationOutcome",
    "issue": [
        {
            "severity": "error",
            "code": "exception",
            "diagnostics": "Transaction failed: conflict detected on resource Patient/example-id"
        }
    ]
}

处理订单

类型的异步捆绑包transaction已排队，但不会按照严格的提交顺序进行处理。 HealthLake 根据可用容量和系统负载优化处理。

配额和限制

以下配额和速率限制适用于异步交易。

错误处理

对于 “事务” 捆绑包，捆绑包中包含的所有 FHIR 资源都将作为原子操作进行处理。操作中的所有资源都必须成功，否则不处理捆绑包中的任何操作。

错误分为两类：同步 HealthLake 返回的提交错误和通过轮询检索的处理错误。

提交错误

HealthLake 在提交时验证捆绑包，并在事务排队之前同步返回错误。提交错误包括无效的 FHIR 资源验证错误、不支持的资源类型、超过 500 个操作限制以及将Prefer: respond-async标题与批处理捆绑包一起使用。如果已达到数据存储的待处理事务限制，则 HealthLake 返回 a ThrottlingException。当发生提交错误时，交易将不会排队。

处理错误

处理错误是在事务排队之后发生的，并通过轮询 URL 返回。其中包括事务冲突，即另一个操作修改了作为事务一部分的资源，以及处理期间的服务器错误。发生处理错误时，不会对事务中的资源进行任何资源变更。轮询网址将返回OperationOutcome包含错误详情的。