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
200con un valorOperationOutcome. - Si la solicitud no es válida o no está autorizada, DDFS devuelve una respuesta de error, normalmente con un valor
OperationOutcomecuando 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. |
Páginas Relacionadas
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. |