As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

AWS HealthLake dá suporte à `$bulk-delete` operação, permitindo a exclusão de todos os recursos de um tipo específico em um armazenamento de dados. Essa operação é particularmente útil quando você precisa:
+ Realize auditorias e limpezas sazonais
+ Gerencie o ciclo de vida dos dados em grande escala
+ Remover tipos de recursos específicos
+ Cumpra as políticas de retenção de dados

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

A `$bulk-delete` operação pode ser invocada usando métodos POST:

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

## Parâmetros
<a name="bulk-delete-parameters"></a>


| Parâmetro | Tipo | Obrigatório | Padrão | Description | 
| --- | --- | --- | --- | --- | 
| isHardDelete | booliano | Não | false | Quando verdadeiro, remove permanentemente os recursos do armazenamento | 
| deleteAuditEvent | booleano | Não | true | Quando verdadeiro, exclui os eventos de auditoria associados | 
| \$1since | string | Não | Hora de criação do armazenamento de dados | Quando inserido, seleciona a hora limite inicial para encontrar recursos com base na hora da Última Modificação. Não pode ser usado com início ou fim | 
| start | string | Não | Hora de criação do armazenamento de dados | Quando inserido, seleciona o horário limite para encontrar recursos com base no horário da Última Modificação. Pode ser usado com extremidade | 
| end | string | Não | Horário de envio do trabalho | Quando inserido, seleciona a hora limite final para encontrar recursos com base na hora da Última Modificação | 

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

**Exemplo de solicitação**  


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

**Exemplo de resposta**  


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

## Status do trabalho
<a name="bulk-delete-job-status"></a>

Para verificar o status de uma tarefa de exclusão em massa:

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

A operação retorna informações sobre o status do trabalho:

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

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

A `$bulk-delete` operação:

1. Processa de forma assíncrona para lidar com grandes volumes de recursos

1. Mantém as transações ACID para a integridade dos dados

1. Fornece rastreamento do status do trabalho com contagens de exclusões de recursos

1. Suporta os modos de exclusão temporária e definitiva

1. Inclui registro abrangente de auditoria das atividades de exclusão

1. Permite a exclusão seletiva de versões históricas e eventos de auditoria

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

A `$bulk-delete` operação é registrada como Iniciar FHIRBulk DeleteJob e Descrever FHIRBulk DeleteJob com informações detalhadas da operação.

## Limitações
<a name="bulk-delete-limitations"></a>
+ Quando `isHardDelete` definido como verdadeiro, os recursos excluídos permanentemente não aparecerão nos resultados da pesquisa ou `_history` nas consultas.
+ Os recursos que estão sendo excluídos por meio dessa operação podem ficar temporariamente inacessíveis durante o processamento.
+ A medição de armazenamento é ajustada somente nas versões históricas - deleteVersionHistory =false não ajusta o armazenamento do armazenamento de dados