Eliminación en masa

"$bulk-delete" permite eliminar recursos del servidor FHIR de forma asincrónica. La operación de eliminación masiva se puede ejecutar en el nivel del sistema o para el tipo de recurso individual.

  • Nivel del sistema: la ejecución de la operación en el nivel del sistema permite la eliminación de recursos de FHIR en todos los tipos de recursos del servidor FHIR.

      DELETE  /$bulkDelete
    
  • Tipo de recurso individual: la ejecución de la operación en tipos de recursos individuales permite la eliminación de la asignación de recursos de FHIR al tipo de recurso especificado en la dirección URL.

      DELETE /<Resource Type>/$bulkDelete
    

Nota:

La eliminación masiva es una operación que se usará con precaución. No se pueden revertir los recursos del servicio FHIR una vez eliminados.

La operación de eliminación masiva está actualmente en versión preliminar pública. Revise la declinación de responsabilidades para obtener más información.

Importante

Las API y los SDK en versión preliminar se proporcionan sin contrato de nivel de servicio. Se recomienda no usarlos para las cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que sus funcionalidades estén limitadas. Para obtener más información, consulte Términos de uso complementarios para las Versiones preliminares de Microsoft Azure.

Encabezados

La operación Bulk-Delete requiere dos parámetros de encabezado

  • Aceptar: application/fhir+json
  • Preferir: respond-async

Parámetros de consulta

Los parámetros de consulta permiten filtrar los recursos sin procesar que pretende eliminar. Para admitir el filtrado, los parámetros de consulta del servicio FHIR son:

Parámetro de consulta Valor predeterminado Descripción
_hardDelete False Para eliminar el recurso, incluida la versión del historial, pase el valor true.
_purgeHistory False Permite eliminar versiones del historial asociadas al recurso.
Parámetros de búsqueda admitidos por el servicio FHIR Permite especificar criterios de búsqueda y recursos que coincidan con los criterios de búsqueda. Ejemplo: address:contains=Meadow subject:Patient.birthdate=1987-02-20

Todos los parámetros de consulta son opcionales.

$bulk-delete Response

Una vez realizada la solicitud para eliminar de forma masiva los recursos de FHIR, en respuesta debe recibir el encabezado Content-Location con la dirección URL absoluta de un punto de conexión para las solicitudes de estado posteriores, como un punto de conexión de sondeo.

Punto de conexión de sondeo: la solicitud al punto de conexión de sondeo tiene uno de los cuatro resultados en función del estado del trabajo de eliminación masiva. El resultado se proporciona en operationOutcome de la respuesta de FHIR.

  1. Trabajos en curso: este resultado indica que el trabajo está en curso. Código de estado 202
  2. Completado: este resultado indica que el trabajo se ha completado correctamente. Al finalizar, la información del número de recursos eliminados se proporcionaría en el nivel de tipo de recurso individual. Código de estado 200
  3. Cancelado: el usuario cancela este trabajo de estados de resultados y proporciona información sobre el número de recursos eliminados en el nivel de tipo de recurso individual. Código de estado 200
  4. Error: este resultado indica que se ha producido un error en el trabajo. El código de estado depende del tipo de error.

Solicitud de ejemplo y respuesta para determinar el estado Solicitud:

{{fhir_url}}/_operations/bulk-delete/<id>

Respuesta de ejemplo del trabajo de eliminación completado correctamente.

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "ResourceDeletedCount",
            "part": [
                {
                    "name": "Practitioner",
                    "valueDecimal": 10.0
                },
                {
                    "name": "Specimen",
                    "valueDecimal": 7.0
                },
                {
                    "name": "Device",
                    "valueDecimal": 3.0
                }
            ]
        }
    ]
}

Pasos siguientes

En este artículo, ha aprendido a eliminar recursos de forma masiva en el servicio FHIR. Para obtener información sobre las características de FHIR admitidas, consulte

FHIR® es una marca registrada de HL7 y se usa con su permiso.