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.

# Eliminar tipos de recursos con `$bulk-delete`
<a name="reference-fhir-operations-bulk-delete"></a>

AWS HealthLake admite la `$bulk-delete` operación, lo que permite eliminar todos los recursos de un tipo específico de un almacén de datos. Esta operación resulta especialmente útil cuando se necesita:
+ Realice auditorías y limpiezas estacionales
+ Gestione el ciclo de vida de los datos a escala
+ Elimine tipos de recursos específicos
+ Cumpla con las políticas de retención de datos

## De uso
<a name="bulk-delete-usage"></a>

La `$bulk-delete` operación se puede invocar mediante los métodos POST:

```
POST [base]/[ResourceType]/$bulk-delete?isHardDelete=false&deleteAuditEvent=true
```

## Parameters
<a name="bulk-delete-parameters"></a>


| Parámetro | Tipo | Obligatorio/a | Predeterminado | Description (Descripción) | 
| --- | --- | --- | --- | --- | 
| isHardDelete | booleano | No | false | Si es verdadero, elimina permanentemente los recursos del almacenamiento | 
| deleteAuditEvent | booleano | No | true | Si es verdadero, elimina los eventos de auditoría asociados | 
| \_since | cadena | No | Hora de creación del almacén de datos | Cuando se introduce, selecciona la hora límite de inicio para buscar los recursos en función de su hora de última modificación. No se puede usar ni al principio ni al final | 
| start | cadena | No | Hora de creación del almacén de datos | Cuando se introduce, selecciona la hora límite para buscar los recursos en función de su hora de última modificación. Se puede usar con el final | 
| end | cadena | No | Tiempo de presentación de trabajos | Cuando se introduce, selecciona la hora límite de finalización para buscar los recursos en función de su hora de última modificación | 

## Ejemplos
<a name="bulk-delete-examples"></a>

**Solicitud de ejemplo**  


```
POST [base]/Observation/$bulk-delete?isHardDelete=false
```

**Respuesta de ejemplo**  


```
{
      "jobId": "jobId",
      "jobStatus": "SUBMITTED"
    }
```

## Estado del trabajo
<a name="bulk-delete-job-status"></a>

Para comprobar el estado de un trabajo de eliminación masiva:

```
GET [base]/$bulk-delete/[jobId]
```

La operación devuelve información sobre el estado del trabajo:

```
{
      "datastoreId": "datastoreId",
      "jobId": "jobId",
      "status": "COMPLETED",
      "submittedTime": "2025-10-09T15:09:51.336Z"
    }
```

## Comportamiento
<a name="bulk-delete-behavior"></a>

La `$bulk-delete` operación:

1. Procesa de forma asíncrona para gestionar grandes volúmenes de recursos

1. Mantiene las transacciones ACID para garantizar la integridad de los datos

1. Proporciona un seguimiento del estado de los trabajos con recuentos de eliminaciones de recursos

1. Soporta los modos de borrado suave y duro

1. Incluye un registro de auditoría completo de las actividades de eliminación

1. Permite la eliminación selectiva de versiones históricas y eventos de auditoría

## Registro de auditoría
<a name="bulk-delete-audit-logging"></a>

La `$bulk-delete` operación se registra como Inicio FHIRBulk DeleteJob y Descripción FHIRBulk DeleteJob con información detallada sobre la operación.

## Limitaciones
<a name="bulk-delete-limitations"></a>
+ Si `isHardDelete` se establece en True, los recursos eliminados de forma permanente no aparecerán en los resultados de búsqueda ni en `_history` las consultas.
+ Es posible que los recursos que se eliminen mediante esta operación no estén accesibles temporalmente durante el procesamiento
+ La medición del almacenamiento solo se ajusta en las versiones históricas; deleteVersionHistory =false no ajustará el almacenamiento en el almacén de datos