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.

Modificación de recursos con la operación PATCH

AWS HealthLake admite la operación PATCH para los recursos del FHIR, lo que le permite modificar los recursos seleccionando elementos específicos para añadirlos, sustituirlos o eliminarlos sin necesidad de actualizar todo el recurso. Esta operación resulta especialmente útil cuando se necesita:

Formatos PATCH compatibles

AWS HealthLake admite dos formatos PATCH estándar:

Parche JSON (RFC 6902)

Utiliza la sintaxis JSON Pointer para seleccionar los elementos según su posición en la estructura de recursos.

Tipo de contenido: application/json-patch+json

FHIRPath Parche (especificación FHIR R4)

Utiliza FHIRPath expresiones para seleccionar los elementos según su contenido y sus relaciones, lo que proporciona un enfoque de aplicación de parches nativo del FHIR.

Tipo de contenido: application/fhir+json

De uso

Operaciones directas de PATCH

La operación PATCH se puede invocar directamente en los recursos del FHIR mediante el método HTTP PATCH:

PATCH [base]/[resource-type]/[id]{?_format=[mime-type]}

PATCH en paquetes

Las operaciones PATCH se pueden incluir como entradas en los paquetes del FHIR batch o bientransaction, lo que permite combinar las operaciones de parche con otras interacciones del FHIR (crear, leer, actualizar, eliminar) en una sola solicitud.

Formato de parche JSON

Operaciones admitidas

Sintaxis de ruta

El parche JSON utiliza la sintaxis JSON Pointer (RFC 6901):

Ejemplos

Solicitud directa de parches JSON con múltiples operaciones

PATCH [base]/Patient/example
Content-Type: application/json-patch+json
If-Match: W/"1"

[
  {
    "op": "replace",
    "path": "/name/0/family",
    "value": "Smith"
  },
  {
    "op": "add",
    "path": "/telecom/-",
    "value": {
      "system": "phone",
      "value": "555-555-5555",
      "use": "home"
    }
  },
  {
    "op": "remove",
    "path": "/address/0"
  },
  {
    "op": "move",
    "from": "/name/0/family",
    "path": "/name/1/family"
  },
  {
    "op": "test",
    "path": "/gender",
    "value": "male"
  },
  {
    "op": "copy",
    "from": "/name/0",
    "path": "/name/1"
  }
]

Solicitud directa de parches JSON con una sola operación

PATCH [base]/Patient/example
Content-Type: application/json-patch+json

[
  {
    "op": "replace",
    "path": "/active",
    "value": false
  }
]

Parche JSON en paquete

Utilice un recurso binario que contenga la carga útil del parche JSON codificada en base64:

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [{
    "resource": {
      "resourceType": "Binary",
      "contentType": "application/json-patch+json",
      "data": "W3sib3AiOiJhZGQiLCJwYXRoIjoiL2JpcnRoRGF0ZSIsInZhbHVlIjoiMTk5MC0wMS0wMSJ9XQ=="
    },
    "request": {
      "method": "PATCH",
      "url": "Patient/123"
    }
  }]
}

FHIRPath Formato de parche

Operaciones admitidas

Sintaxis de ruta

FHIRPath El parche usa FHIRPath expresiones que admiten:

Ejemplos

Solicitud de parche directa FHIRPath

PATCH [base]/Patient/123
Content-Type: application/fhir+json
Authorization: ...

{
  "resourceType": "Parameters",
  "parameter": [{
    "name": "operation",
    "part": [
      { "name": "type", "valueCode": "add" },
      { "name": "path", "valueString": "Patient" },
      { "name": "name", "valueString": "birthDate" },
      { "name": "value", "valueDate": "1990-01-01" }
    ]
  }]
}

FHIRPath Parche en paquete

Utilice un recurso de parámetros como recurso de entrada conmethod: PATCH:

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [{
    "resource": {
      "resourceType": "Parameters",
      "parameter": [{
        "name": "operation",
        "part": [
          { "name": "type", "valueCode": "add" },
          { "name": "path", "valueString": "Patient" },
          { "name": "name", "valueString": "birthDate" },
          { "name": "value", "valueDate": "1990-01-01" }
        ]
      }]
    },
    "request": {
      "method": "PATCH",
      "url": "Patient/123"
    }
  }]
}

Encabezados de solicitud

Respuesta de ejemplo

La operación devuelve el recurso actualizado con la información de la nueva versión:

HTTP/1.1 200 OK
Content-Type: application/fhir+json
ETag: W/"2"
Last-Modified: Mon, 05 May 2025 10:10:10 GMT

{
  "resourceType": "Patient",
  "id": "example",
  "active": true,
  "name": [
    {
      "family": "Smith",
      "given": ["John"]
    }
  ],
  "telecom": [
    {
      "system": "phone",
      "value": "555-555-5555",
      "use": "home"
    }
  ],
  "meta": {
    "versionId": "2",
    "lastUpdated": "2025-05-05T10:10:10Z"
  }
}

Comportamiento

La operación PATCH:

Gestión de errores

La operación gestiona las siguientes condiciones de error:

Resumen de capacidades

Limitaciones

Recursos adicionales

Para obtener más información sobre las operaciones PATCH, consulte: