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

使用 大規模修補資源 $bulk-patch

AWS HealthLake 支援以非同步方式將修補程式操作套用至大量 FHIR 資源$bulk-patch的操作。您可以依 ID 或資料存放區中指定類型的所有資源，將特定資源清單設為目標。透過此操作，您可以大規模修改資源，而無需個別更新每個資源。

當您需要執行下列動作時， $bulk-patch操作特別有用：

Usage

$bulk-patch 操作是非同步的。若要開始任務，請提交 POST 請求：

POST [base]/$bulk-patch

若要輪詢任務的狀態，請使用描述端點：

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

若要開始使用 $bulk-patch操作，請執行下列動作：

Parameters

$bulk-patch 操作支援下列參數。

以資源為目標

您可以透過兩種模式將資源設為目標。

資源類型模式

在資源類型模式中， 操作會修補資料存放區中特定類型的所有資源。

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

資源 IDs 模式

在資源 IDs模式中， 操作會依 ID 修補特定資源清單。所有資源 IDs都必須是相同的類型，且符合 resourceType 參數。格式可以是完整參考 ([resourceType]/[id]) 或僅限 ID ([id])。清單最多可包含 50，000 IDs。

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

支援的修補程式格式

$bulk-patch 此操作同時支援 JSON 修補程式 (RFC 6902) 和 FHIR 修補程式 (FHIRPath 型） 語法。它使用與同步 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 操作專為大量處理而設計，並以非同步方式執行。

相關的 操作