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á.

# Removendo recursos permanentemente com `$erase`
<a name="reference-fhir-operations-erase"></a>

AWS HealthLake suporta a `$erase` operação, permitindo a exclusão permanente de um recurso específico e de suas versões históricas. Essa operação é particularmente útil quando você precisa:
+ Remova permanentemente recursos individuais
+ Excluir históricos de versões específicos
+ Gerencie ciclos de vida de recursos individuais
+ Cumpra os requisitos específicos de remoção de dados

## Usage
<a name="erase-usage"></a>

A `$erase` operação pode ser invocada em dois níveis:

**Nível de instância do recurso**  


```
POST [base]/[ResourceType]/[ID]/$erase?deleteAuditEvent=true
```

**Nível específico da versão**  


```
POST [base]/[ResourceType]/[ID]/_history/[VersionID]/$erase
```

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


| Parâmetro | Tipo | Obrigatório | Padrão | Description | 
| --- | --- | --- | --- | --- | 
| deleteAuditEvent | booliano | Não | false | Quando verdadeiro, exclui os eventos de auditoria associados | 

## Exemplos
<a name="erase-examples"></a>

**Exemplo de solicitação**  


```
POST [base]/Patient/example-patient/$erase
```

**Exemplo de resposta**  


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

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

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

```
GET [base]/$erase/[jobId]
```

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

```
{
      "datastoreId": "36622996b1fcecb7e12ee2ee085308d3",
      "jobId": "5df47e2f51ff3c731847678cb8cad48e",
      "status": "COMPLETED",
      "submittedTime": "2025-10-30T16:39:24.160Z"
    }
```

## Comportamento
<a name="erase-behavior"></a>

A `$erase` operação:

1. Processa de forma assíncrona para garantir a integridade dos dados

1. Mantém transações ACID

1. Fornece rastreamento do status do trabalho

1. Remove permanentemente o recurso especificado e suas versões

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

1. Oferece suporte à exclusão seletiva de eventos de auditoria

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

A `$erase` operação é registrada DeleteResource com o ID do usuário, o carimbo de data/hora e os detalhes do recurso.

## Limitações
<a name="erase-limitations"></a>
+ `$erased`o recurso não aparecerá nos resultados da pesquisa ou `_history` nas consultas.
+ Os recursos que estão sendo apagados podem ficar temporariamente inacessíveis durante o processamento
+ A medição de armazenamento é ajustada imediatamente à medida que os recursos são removidos permanentemente