Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Agrupación de recursos del FHIR

Un FHIR Bundle es un contenedor que contiene una colección de recursos del FHIR. AWS HealthLake AWS HealthLake admite dos tipos de paquetes con diferentes comportamientos de procesamiento.

Batchlos paquetes procesan cada recurso de forma independiente. Si un recurso falla, los recursos restantes aún pueden funcionar correctamente. Cada operación se procesa de forma individual y el procesamiento continúa incluso cuando algunas operaciones fallan. Utilice paquetes por lotes para operaciones masivas en las que sea aceptable un éxito parcial, como cargar varios historiales de pacientes no relacionados.

Transactionlos paquetes procesan todos los recursos de forma atómica como una sola unidad. Todas las operaciones de recursos se realizan correctamente o no AWS HealthLake se compromete ninguna de ellas. Utilice los paquetes de transacciones cuando necesite garantizar la integridad referencial en todos los recursos relacionados, por ejemplo, si crea un paciente con observaciones y afecciones relacionadas, en el que todos los datos deben registrarse juntos.

Puede agrupar recursos del FHIR del mismo tipo o de tipos diferentes, y estos pueden incluir una combinación de operaciones del FHIRcreate, como, read updatedelete, y. patch Para obtener información adicional, consulte el paquete de recursos en la documentación del FHIR R4.

A continuación se muestran ejemplos de casos de uso para cada tipo de paquete.

El siguiente ejemplo muestra un paquete de transacciones con varios tipos de recursos y operaciones.

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

Agrupar los recursos del FHIR como entidades independientes

Para agrupar los recursos del FHIR como entidades independientes

Condicional PUTs en paquetes

AWS HealthLake admite las actualizaciones condicionales dentro de los paquetes mediante los siguientes parámetros de consulta:

Cuando utilizas la opción condicional PUTs en paquetes, AWS HealthLake evalúa los parámetros de la consulta comparándolos con los recursos existentes y toma medidas en función de los resultados de las coincidencias.

En el siguiente paquete de ejemplo con una actualización condicional, el Patient recurso con el identificador FHIR se 476 actualiza solo si _lastUpdated=lt2025-04-20 se cumple la condición.

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

Agrupar los recursos del FHIR como una sola entidad

Para agrupar los recursos del FHIR como una sola entidad

Configurar el nivel de validación de los paquetes

Al agrupar los recursos del FHIR, puede especificar opcionalmente un encabezado x-amzn-healthlake-fhir-validation-level HTTP para configurar un nivel de validación para el recurso. Este nivel de validación se establecerá para todas las solicitudes de creación y actualización del paquete. AWS HealthLake actualmente admite los siguientes niveles de validación:

Los recursos incluidos con un nivel de validación mínimo pueden incorporarse a un almacén de datos a pesar de no pasar la validación necesaria para la indexación de las búsquedas. En este caso, los recursos se actualizarán para incluir una extensión específica de Healthlake para documentar dichos errores, y las entradas de la respuesta del paquete incluirán los siguientes recursos: 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."
                        }
                    ]
                }
            }
        }
    ]
}

Además, se incluirá el siguiente encabezado de respuesta HTTP con el valor «true»:

x-amzn-healthlake-validation-issues : true

Soporte limitado para el tipo de paquete «mensaje»

HealthLake proporciona un soporte limitado para el tipo de paquete FHIR message mediante un proceso de conversión interno. Este soporte está diseñado para situaciones en las que los paquetes de mensajes no se pueden volver a formatear en su origen, por ejemplo, cuando se ingieren ficheros ADT (admisión, alta, transferencia) de sistemas hospitalarios antiguos.

Diferencias clave con respecto al procesamiento de mensajes estándar

Limitaciones importantes

Ejemplo de estructura de paquete de mensajes

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

Transacciones de paquetes asíncronas

AWS HealthLake admite el Bundle tipo asíncrono transaction que le permite enviar transacciones con hasta 500 recursos. Al enviar una transacción asíncrona, la pone en HealthLake cola para su procesamiento e inmediatamente devuelve una URL de sondeo. Puedes usar esta URL para comprobar el estado y recuperar la respuesta. Sigue el patrón de paquetes asíncronos del FHIR.

Cuándo usar transacciones asíncronas

Enviar una transacción asíncrona

Para enviar una transacción asíncrona, envíe una POST solicitud al punto final del almacén de datos con el encabezado. Prefer: respond-async El paquete debe tener un tipo. transaction Los paquetes con un tipo no batch se admiten para el procesamiento asíncrono de paquetes.

HealthLake realiza las validaciones iniciales del paquete en el momento de su envío. Si la validación se realiza correctamente, HealthLake devuelve HTTP 202 Accepted con un encabezado de content-location respuesta que contiene la URL de la encuesta.

Para enviar un tipo Bundle asíncrono transaction

Sondeo del estado de la transacción

Después de enviar una transacción asíncrona, usa la URL de sondeo del encabezado de content-location respuesta para comprobar el estado de la transacción. Envía una GET solicitud a la URL de la encuesta.

Envíe una GET solicitud a la URL de la encuesta. En el siguiente ejemplo, se utiliza la herramienta de línea de curl comandos.

SigV4

Autorización 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

Autorización SMART sobre la FHIR. El token de autorización debe incluir read los permisos correspondientes al tipo Transaction de recurso.

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

En la siguiente tabla se describen las posibles respuestas.

Los siguientes ejemplos muestran cada tipo de respuesta.

Transacción en cola (202)

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

Procesamiento de transacciones (202)

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

Transacción completada (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"
            }
        }
    ]
}

Transacción fallida (4xx/5xx)

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

Procesando el pedido

Los paquetes de tipo asíncrono transaction están en cola, pero no se procesan siguiendo un orden de envío estricto. HealthLake optimiza el procesamiento en función de la capacidad disponible y la carga del sistema.

Cuotas y limitaciones

Las siguientes cuotas y límites de tasa se aplican a las transacciones asincrónicas.

Gestión de errores

En el caso de un paquete de «transacciones», todos los recursos del FHIR contenidos en el paquete se procesan como una operación atómica. Todos los recursos de la operación deben realizarse correctamente o no se procesará ninguna operación del paquete.

Los errores se dividen en dos categorías: los errores de envío, que se HealthLake devuelven de forma sincrónica, y los errores de procesamiento, que se recuperan mediante un sondeo.

Errores de envío

HealthLake valida el paquete en el momento del envío y devuelve los errores de forma sincrónica antes de que la transacción se ponga en cola. Los errores de envío incluyen los errores de validación de recursos del FHIR no válidos, los tipos de recursos no admitidos, la superación del límite de 500 operaciones y el uso del Prefer: respond-async encabezado con paquetes de lotes. Si se ha alcanzado el límite de transacciones pendientes del almacén de datos, HealthLake devuelve un. ThrottlingException Cuando se produce un error de envío, la transacción no se pondrá en cola.

Errores de procesamiento

Los errores de procesamiento se producen después de poner la transacción en cola y se devuelven a través de la URL de sondeo. Estos incluyen los conflictos de transacciones, en los que otra operación modificó un recurso que forma parte de la transacción, y los errores del servidor durante el procesamiento. Cuando se produce un error de procesamiento, no se produce ninguna mutación de recursos para los recursos de la transacción. La URL del sondeo devolverá una OperationOutcome con los detalles del error.