Depurar recursos de FHIR eliminados

Utilice la operación DDFS $purgeDeleted para eliminar de forma permanente los recursos de FHIR suprimidos para un tipo de recurso soportado.

La operación $purgeDeleted depura permanentemente los recursos suprimidos del tipo solicitado que se han suprimido antes de una hora de corte especificada. La operación devuelve un FHIR OperationOutcome que describe el resultado de la depuración.

Utilice $purgeDeleted solo para los recursos que ya están en estado suprimido. Para suprimir una instancia de recurso actual, primero utilice la interacción de supresión de FHIR estándar.

Punto final

POST /api/fhir/{r4|r6-ballot4}/{Resource}/$purgeDeleted
Accept: application/fhir+json
Content-Type: application/fhir+json
Authorization: Bearer <access-token>

Parámetros

Parámetro Entrante Necesario Tipo Descripción
before cuerpo verdadero dateTime Corte de FHIR Parameters.parameter.valueDateTime. Los recursos suprimidos antes de este instante se pueden depurar.
limit cuerpo falso entero FHIR Parameters.parameter.valueInteger. El rango aceptado es del 1 al 50.

Autorización

La operación requiere un permiso de supresión de recursos coincidente y el ámbito de supresión permanente de DDFS.

  • Otorgamiento de supresión de recurso: system/{Resource}.d
  • Ámbito de supresión permanente: https://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete

Los permisos de aplicación cliente y las solicitudes de token utilizan el formulario fijo con prefijo ddfs tanto para los ámbitos de recursos de FHIR como para el ámbito de supresión permanente personalizado. Por ejemplo, un cliente de purga de paciente solicita ddfssystem/Patient.d y ddfshttps://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete. El token emitido contiene los ámbitos canónicos correspondientes, system/Patient.d y https://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete. Para obtener información sobre la sintaxis del ámbito, consulte Autenticación y ámbitos. Para la configuración del cliente OAuth, consulte Configuración de la aplicación cliente.

Ejemplos

Depure hasta 25 recursos suprimidos que se suprimieron antes del corte:

POST /api/fhir/r4/Patient/$purgeDeleted
Accept: application/fhir+json
Content-Type: application/fhir+json
Authorization: Bearer <access-token>

{
  "resourceType": "Parameters",
  "parameter": [
    { "name": "before", "valueDateTime": "2026-01-01T00:00:00Z" },
    { "name": "limit", "valueInteger": 25 }
  ]
}

Utilice el mismo cuerpo Parameters de FHIR con un punto final de recurso R6, por ejemplo, POST /api/fhir/r6-ballot4/Observation/$purgeDeleted.

Comportamiento

  • La operación se aplica a un tipo de recurso a la vez.
  • La operación elimina permanentemente los recursos suprimidos que coinciden con los requisitos de corte y autorización.
  • Cuando se proporciona limit, DDFS limita el número de recursos depurados por esa solicitud.
  • Una solicitud correcta devuelve HTTP 200 con un valor OperationOutcome.
  • Si la solicitud no es válida o no está autorizada, DDFS devuelve una respuesta de error, normalmente con un valor OperationOutcome cuando se devuelve un cuerpo de error con formato FHIR.

Recursos soportados

DDFS admite $purgeDeleted para los siguientes tipos de recursos de FHIR.

Versión de FHIR Recursos
4ª CareTeam, CarePlan, Immunization, Condition, Device, DiagnosticReport, Encounter, Endpoint, FamilyMemberHistory, Group, Location, Observation, Organization, Patient, Practitioner, PractitionerRole, Provenance, RelatedPerson, ServiceRequest, and Specimen.
6º Device, DeviceAssociation, Encounter, Location, Observation, Patient, Practitioner, PractitionerRole, Provenance, Subscription y SubscriptionTopic.

Detalles de contrato de FHIR

Las operaciones $purgeDeleted y $hardDelete eliminan datos de forma permanente. Confirme los requisitos de OperationDefinition, soporte de recursos y autorización aplicables antes de utilizar cualquiera de las operaciones.

Definiciones y alcance de la operación

Versión Operación Definición Alcance de llamada Recursos Afecta al estado Estado Descripción
4ª $hardDelete ddfs-r4-hardDelete.json nivel de instancia CareTeam, CarePlan, Vacunación, Condición, Dispositivo, DiagnosticReport, Episodio clínico, Punto final, FamilyMemberHistory, Grupo, Ubicación, Observación, Organización, Paciente, Practicante, PractitionerRole, Procedencia, RelatedPerson, ServiceRequest, Muestra Sí activa Elimina permanentemente una instancia de recurso suprimida. Esta operación de nivel de instancia devuelve un OperationOutcome y necesita una autoridad de supresión del sistema/{Resource}.d coincidente y el ámbito personalizado exacto https://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete.
4ª $purgeDeleted ddfs-r4-purgeDeleted.json nivel de tipo CareTeam, CarePlan, Vacunación, Condición, Dispositivo, DiagnosticReport, Episodio clínico, Punto final, FamilyMemberHistory, Grupo, Ubicación, Observación, Organización, Paciente, Practicante, PractitionerRole, Procedencia, RelatedPerson, ServiceRequest, Muestra Sí activa Purga permanentemente los recursos suprimidos del tipo solicitado que se suprimieron antes de la fecha/hora requerida, opcionalmente limitada a entre 1 y 50 recursos. Las entradas se proporcionan en el cuerpo de parámetros de FHIR de POST. Esta operación de nivel de tipo devuelve un OperationOutcome y necesita una autoridad de supresión de system/{Resource}.d coincidente y el ámbito personalizado exacto https://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete.
6º $hardDelete ddfs-r6-hardDelete.json nivel de instancia Dispositivo, DeviceAssociation, Episodio clínico, Ubicación, Observación, Paciente, Profesional, PractitionerRole, Procedencia, Suscripción, SubscriptionTopic Sí activa Elimina permanentemente una instancia de recurso suprimida. Esta operación de nivel de instancia devuelve un OperationOutcome y necesita una autoridad de supresión del sistema/{Resource}.d coincidente y el ámbito personalizado exacto https://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete.
6º $purgeDeleted ddfs-r6-purgeDeleted.json nivel de tipo Dispositivo, DeviceAssociation, Episodio clínico, Ubicación, Observación, Paciente, Profesional, PractitionerRole, Procedencia, Suscripción, SubscriptionTopic Sí activa Purga permanentemente los recursos suprimidos del tipo solicitado que se suprimieron antes de la fecha/hora requerida, opcionalmente limitada a entre 1 y 50 recursos. Las entradas se proporcionan en el cuerpo de parámetros de FHIR de POST. Esta operación de nivel de tipo devuelve un OperationOutcome y necesita una autoridad de supresión de system/{Resource}.d coincidente y el ámbito personalizado exacto https://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete.

Parámetros

Versión Operación Parámetro Usar Mínimo Máx Tipo Descripción
4ª $hardDelete return salida 1 1 Resultado de operación Operación Resultado que describe el resultado de eliminación definitiva.
4ª $purgeDeleted before en 1 1 dateTime Se ha proporcionado el corte de dateTime de FHIR necesario como Parameters.parameter.valueDateTime; los recursos suprimidos antes de este instante se depuran.
4ª $purgeDeleted limit en 0 1 entero Máximo opcional proporcionado como Parameters.parameter.valueInteger. La ruta acepta valores del 1 al 50.
4ª $purgeDeleted return salida 1 1 Resultado de operación Operación Resultado que describe el resultado de la purga.
6º $hardDelete return salida 1 1 Resultado de operación Operación Resultado que describe el resultado de eliminación definitiva.
6º $purgeDeleted before en 1 1 dateTime Se ha proporcionado el corte de dateTime de FHIR necesario como Parameters.parameter.valueDateTime; los recursos suprimidos antes de este instante se depuran.
6º $purgeDeleted limit en 0 1 entero Máximo opcional proporcionado como Parameters.parameter.valueInteger. La ruta acepta valores del 1 al 50.
6º $purgeDeleted return salida 1 1 Resultado de operación Operación Resultado que describe el resultado de la purga.