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

使用 $bulk-patch 大规模修补资源

AWS HealthLake 支持将补丁$bulk-patch操作异步应用于大量 FHIR 资源的操作。您可以按 ID 定位特定的资源列表，也可以将数据存储中给定类型的所有资源作为目标。通过此操作，您可以大规模修改资源，而无需单独更新每种资源。

当你需要执行以下$bulk-patch操作时，该操作特别有用：

用量

该$bulk-patch操作是异步的。要开始作业，请提交 POST 请求：

POST [base]/$bulk-patch

要轮询任务的状态，请使用描述端点：

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

要开始$bulk-patch操作，请执行以下操作：

参数

该$bulk-patch操作支持以下参数。

定位资源

您可以采用两种模式来定位资源。

资源类型模式

在资源类型模式下，该操作会修补数据存储库中特定类型的所有资源。

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

资源 ID 模式

在资源 ID 模式下，该操作按 ID 修补特定的资源列表。所有资源 ID 必须是相同类型且与resourceType参数相匹配。格式可以是完整参考文献 ([resourceType]/[id])，也可以只是 ID ([id])。该列表最多可包含 50,000 个资源 ID。

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

支持的补丁格式

该$bulk-patch操作支持 JSON 补丁 (RFC 6902) 和 FHIR 补丁 () 语法。FHIRPath-based它使用与同步 PATCH 操作相同的支持操作集和相同的语法。有关更多信息，请参阅 使用 PATCH 操作修改资源。

启动批量补丁任务示例

以下示例提交了批量补丁作业，该任务使用 FHIR 补丁向特定Patient资源添加合规性标签。

请求示例

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

响应示例

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

批量补丁任务状态轮询

提交任务后，轮询任务状态以跟踪进度并检索结果。作业通过SUBMITTED和IN_PROGRESS，然后过渡到COMPLETED或的终端状态COMPLETED_WITH_ERRORS。

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

以下示例显示了对正在进行的任务的响应。

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

当任务达到终端状态时，描述响应包括成功、失败和跳过的资源的计数摘要。如果有任何资源出现故障或被跳过，响应会在failedResources和skippedResources中列出原因。任务状态是指出现任何故障COMPLETED_WITH_ERRORS时，无论是客户错误还是服务器错误。响应大小限制了failedResources和skippedResources列表，因此它们可能会被截断。检查failedResourcesTruncated并skippedResourcesTruncated确定完整清单是否包括在内。

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

常见的跳过原因

该操作会在资源处于作用域内时跳过该资源，但无法修补该资源，因为该资源的状态在任务提交和处理之间发生了变化。跳过的资源不被视为错误。以下是跳过资源的常见原因。

常见的客户故障

当由于资源或补丁操作出现问题而导致操作无法应用补丁时，资源会失败。失败的资源包括一条带有诊断详细信息的错误消息。以下是常见的客户故障。

最佳实践

我们建议您在使用该$bulk-patch操作时采用以下最佳做法。

Authorization

该$bulk-patch操作支持以下授权方法：

性能特征

该$bulk-patch操作专为高容量处理而设计，并异步运行。

相关 操作