Creación, actualización y restauración de recursos con PUT
Utilice los ID lógicos asignados por el cliente con FHIR R4 4.0.1 y FHIR R6 6.0.0-ballot4.
Comprobar disponibilidad
Compruebe el recurso de destino en el servidor desplegado CapabilityStatement. Un recurso con updateCreate=true admite la creación y restauración con PUT. Esta capacidad también se aplica a las entradas PUT por lotes admitidas.
Seleccionar un ID lógico
Los ID lógicos son cadenas sensibles a mayúsculas/minúsculas de 1 a 64 letras ASCII, dígitos, guiones o puntos, que coinciden con [A-Za-z0-9.-]{1,64}. Por ejemplo, Client.123-A y client.123-a son identidades diferentes. Se admiten UUID. Una identidad tiene su ámbito en su tipo de recurso: Patient/Client.123-A y Device/Client.123-A no chocan.
Conservar el ID exacto al leer, buscar con _id, leer versiones históricas, crear referencias locales, actualizar o suprimir. Componentes de ruta de acceso de porcentaje de código y valores de consulta al crear URL.
Los clientes son responsables de coordinar los ID asignados. PUT a un ID ocupado actualiza su recurso existente; no detecta si esa identidad pertenece al mismo registro en el sistema de origen. Utilice una estrategia de asignación de ID resistente a colisiones y las condiciones previas de versión soportadas al sustituir una representación existente. POST asigna un ID en el servidor e ignora un ID de cliente enviado.
Crear, sustituir y restaurar
PUT [base]/Patient/Client.123-A
Content-Type: application/fhir+json
Prefer: return=representation
{"resourceType":"Patient","id":"Client.123-A","active":true}
El cuerpo debe contener el tipo de recurso solicitado y un ID idéntico al ID de URL. Los ID faltantes o no coincidentes, los tipos de recursos incorrectos, el contenido con formato incorrecto y los fallos básicos de validación de FHIR devuelven 400 con una FHIR segura OperationOutcome. El rechazo de regla de negocio aplicable devuelve 422.
| Estado actual | Resultado correcto |
|---|---|
| ID no utilizado | 201 Created, versión 1, exactamente en el ID solicitado. |
| Recurso activo | 200 OK, la siguiente versión de la misma identidad. |
| Recurso suprimido lógicamente | 201 Created, una representación activa restaurada con la siguiente versión después del marcador de supresión. Las versiones anteriores y el marcador de supresión permanecen accesibles mediante lecturas con versiones; la lectura de la versión de supresión devuelve 410 Gone. |
El servidor asigna meta.versionId y meta.lastUpdated e ignora los valores enviados para estos campos. Las respuestas PUT correctas incluyen ETag, Last-Modified y Location específicos de la versión resultantes, como [base]/Patient/Client.123-A/_history/1.
Prefer: return=representation devuelve el recurso persistente; return=minimal no devuelve ningún cuerpo; return=OperationOutcome devuelve un resultado informativo. Las cabeceras de estado y versión aún identifican el resultado confirmado. Sin una preferencia de devolución, el servidor devuelve la representación.
La creación y restauración aplican las reglas de ciclo de vida y validación de creación del recurso. Por ejemplo, una suscripción R6 restaurada debe cumplir las reglas de creación de suscripciones y completar su establecimiento de comunicación antes de activarse.
Permisos y condiciones previas a la versión
La creación y restauración requieren permisos de creación y actualización. Por ejemplo, otorgue y solicite ddfssystem/Patient.cu; el token emitido utiliza system/Patient.cu. La actualización de un recurso activo requiere permiso de actualización, como system/Patient.u. Las restricciones de acceso a recursos aplicables se aplican al recurso existente y a la sustitución enviada. Un emisor de llamada autenticado sin los permisos necesarios recibe un resultado 403 seguro sin escritura.
Utilice If-Match: W/"4" para sustituir la versión 4. Una condición que no coincide devuelve 412 Precondition Failed sin escrituras. Cualquier condición If-Match válida proporcionada, incluida *, necesita un destino existente y no puede crear un ID no utilizado. Para la restauración, compare con la versión de supresión actual, no con la última versión activa. Las cabeceras If-Match con formato incorrecto devuelven 400.
Las escrituras en competencia pueden devolver 409 Conflict o, cuando una condición previa de versión pierde una carrera, 412. Lea el estado actual y decida si un reintento es adecuado. Las escrituras rechazadas no cambian el recurso, su historial ni los registros FHIR relacionados.
Utilizar PUT en un lote
La interacción en batch de FHIR acepta entradas PUT con el mismo ID, autorización, validación y comportamiento de creación/actualización/restauración. Cada entrada de respuesta informa de su propio estado, cabeceras de versión y representación. Las entradas siguen siendo independientes: una entrada fallida no revierte las entradas no relacionadas correctas. Las entradas de lote deben ser independientes. Los campos de solicitud condicional, incluido entry.request.ifMatch, no son compatibles; utilice una PUT directa cuando necesite protección If-Match. Consulte Envío de solicitudes independientes en un lote.
Estándares con versiones
Consulte los requisitos de actualización de FHIR R4 y los requisitos de actualización de la boleta 4 de FHIR R6.