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 do compartimento do paciente com `$purge`
<a name="reference-fhir-operations-purge"></a>

AWS HealthLake suporta a `$purge` operação, permitindo a exclusão permanente de todos os recursos dentro do compartimento do paciente. Essa operação é particularmente útil quando você precisa:
+ Remova todos os dados associados a um paciente
+ Cumpra as solicitações de remoção de dados do paciente
+ Gerencie o ciclo de vida dos dados do paciente
+ Execute uma limpeza abrangente do prontuário do paciente

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

A `$purge` operação pode ser invocada nos recursos do paciente:

```
POST [base]/Patient/[ID]/$purge?deleteAuditEvent=true
```

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


| Parâmetro | Tipo | Obrigatório | Padrão | Description | 
| --- | --- | --- | --- | --- | 
| deleteAuditEvent | booliano | Não | false | Quando verdadeiro, exclui os eventos de auditoria associados | 
| \$1since | string | Não | Horário 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 | Horário 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="purge-examples"></a>

**Exemplo de solicitação**  


```
POST [base]/Patient/example-patient/$purge?deleteAuditEvent=true
```

**Exemplo de resposta**  


```
{
  "resourceType": "OperationOutcome",
  "id": "purge-job",
  "issue": [
    {
      "severity": "information",
      "code": "informational",
      "diagnostics": "Purge job started successfully. Job ID: 12345678-1234-1234-1234-123456789012"
    }
  ]
}
```

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

Para verificar o status de uma tarefa de expurgação:

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

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

```
{
      "datastoreId": "36622996b1fcecb7e12ee2ee085308d3",
      "jobId": "3dd1c7a5b6c0ef8c110f566eb87e2ef9",
      "status": "COMPLETED",
      "submittedTime": "2025-10-31T18:43:21.822Z"
    }
```

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

A `$purge` operação:

1. Processa de forma assíncrona para lidar com vários 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. Remove permanentemente todos os recursos no compartimento do paciente

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="purge-audit-logging"></a>

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

## Limitações
<a name="purge-limitations"></a>
+ Os recursos eliminados não aparecerão nas respostas de pesquisa
+ Os recursos que estão sendo eliminados podem ficar temporariamente inacessíveis durante o processamento
+ Todos os recursos no compartimento do paciente são removidos permanentemente