As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Corrigindo recursos em grande escala com $bulk-patch

AWS HealthLake suporta a $bulk-patch operação de aplicação de operações de patch a um grande número de recursos FHIR de forma assíncrona. Você pode segmentar uma lista específica de recursos por ID ou todos os recursos de um determinado tipo em um armazenamento de dados. Com essa operação, você pode modificar recursos em grande escala sem atualizar cada recurso individualmente.

A $bulk-patch operação é particularmente útil quando você precisa fazer o seguinte:

Usage

A $bulk-patch operação é assíncrona. Para iniciar um trabalho, envie uma solicitação POST:

POST [base]/$bulk-patch

Para pesquisar o status de um trabalho, use o endpoint de descrição:

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

Para começar a $bulk-patch operação, faça o seguinte:

Parâmetros

A $bulk-patch operação suporta os seguintes parâmetros.

Recursos de segmentação

Você pode direcionar recursos em dois modos.

Modo de tipo de recurso

No modo de tipo de recurso, a operação corrige todos os recursos de um tipo específico no armazenamento de dados.

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

Modo de IDs de recursos

No modo de IDs de recursos, a operação corrige uma lista específica de recursos por ID. Todos os IDs de recursos devem ser do mesmo tipo e corresponder ao resourceType parâmetro. O formato pode ser uma referência completa ([resourceType]/[id]) ou somente o ID ([id]). A lista pode conter até 50.000 IDs de recursos.

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

Formatos de patch suportados

A $bulk-patch operação suporta a sintaxe JSON Patch (RFC 6902) e FHIR Patch (). FHIRPath-based Ele usa o mesmo conjunto de operações suportadas e a mesma sintaxe da operação PATCH síncrona. Para obter mais informações, consulte Modificando recursos com a operação PATCH.

Exemplo de trabalho de patch em massa para iniciar

O exemplo a seguir envia um trabalho de patch em massa que adiciona uma tag de conformidade a Patient recursos específicos usando o FHIR Patch.

Exemplo de solicitação

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

Exemplo de resposta

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

Pesquisa de status do trabalho de patch em massa

Depois de enviar um trabalho, pesquise o status do trabalho para acompanhar o progresso e recuperar os resultados. O trabalho passa por SUBMITTED e eIN_PROGRESS, em seguida, para um estado terminal de COMPLETED ouCOMPLETED_WITH_ERRORS.

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

O exemplo a seguir mostra uma resposta para um trabalho que está em andamento.

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

Quando o trabalho atinge um estado terminal, a resposta de descrição inclui um resumo da contagem de recursos bem-sucedidos, com falha e ignorados. Se algum recurso falhou ou foi ignorado, a resposta lista os motivos em e. failedResources skippedResources O status do trabalho é COMPLETED_WITH_ERRORS quando há alguma falha, seja um erro do cliente ou um erro do servidor. O tamanho da resposta limita as skippedResources listas failedResources e, portanto, elas podem ser truncadas. Verifique failedResourcesTruncated e determine skippedResourcesTruncated se a lista completa está incluída.

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

Razões comuns ignoradas

A operação ignora um recurso quando ele está no escopo, mas não pode corrigir o recurso porque seu estado mudou entre o envio e o processamento do trabalho. Recursos ignorados não são considerados erros. A seguir estão os motivos comuns pelos quais um recurso é ignorado.

Falhas comuns de clientes

Um recurso falha quando a operação não pode aplicar o patch devido a um problema com o recurso ou com as operações do patch. Os recursos com falha incluem uma mensagem de erro com detalhes do diagnóstico. A seguir estão as falhas comuns dos clientes.

Práticas recomendadas

Recomendamos as seguintes práticas recomendadas ao usar a $bulk-patch operação.

Autorização

A $bulk-patch operação oferece suporte aos seguintes métodos de autorização:

Características de desempenho

A $bulk-patch operação foi projetada para processamento de alto volume e é executada de forma assíncrona.

Operações do relacionadas