Compartilhar via


Exclusão em Massa

'$bulk-delete' permite excluir recursos do servidor FHIR de forma assíncrona. A operação de exclusão em massa pode ser executada no nível do sistema ou para o tipo de recurso individual.

  • Nível do sistema: A execução da operação no nível do sistema permite a exclusão de recursos FHIR em todos os tipos de recursos no servidor FHIR.

      DELETE  /$bulkDelete
    
  • Tipo de recurso individual: A execução da operação em tipos de recursos individuais permite a exclusão do mapeamento de recursos FHIR para o tipo de recurso especificado na url.

      DELETE /<Resource Type>/$bulkDelete
    

Observação

A exclusão em massa é uma operação a ser usada com cautela. Os recursos no serviço FHIR, uma vez excluídos, não podem ser revertidos.

A operação de exclusão em massa está atualmente em visualização pública. Revise a isenção de responsabilidade para obter detalhes.

Importante

Versões prévias das APIs e dos SDKs são fornecidas sem um contrato de nível de serviço. É recomendável que você não as use para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou talvez ter restrição de recursos. Para saber mais, consulte os Termos de Uso Complementares das Versões Prévias do Microsoft Azure.

Cabeçalhos

A operação Bulk-Delete requer dois parâmetros de cabeçalho

  • Aceitar: application/fhir+json
  • Preferência: respond-async

Parâmetros de consulta

Os parâmetros de consulta permitem filtrar recursos brutos que você pretende excluir. Para dar suporte à filtragem, os parâmetros de consulta do serviço FHIR são:

Parâmetro de consulta Valor padrão Descrição
_hardDelete Falso Para exclusão de recurso, incluindo a versão do histórico, passe o valor true.
_purgeHistory Falso Permite excluir versões do histórico associadas ao recurso.
Parâmetros de pesquisa suportados pelo serviço FHIR Permite especificar critérios de pesquisa e os recursos correspondentes aos critérios de pesquisa são excluídos. Exemplo: endereço:contém=Prado assunto:Patient.birthdate=1987-02-20

Todos os parâmetros de consulta são opcionais.

$bulk-excluir Resposta

Depois que a solicitação for feita para excluir em massa recursos FHIR, em resposta, você deverá receber o cabeçalho Content-Location com a URL absoluta de um ponto de extremidade para solicitações de status subsequentes, como um ponto de extremidade de sondagem.

Ponto de extremidade de sondagem: a solicitação para o ponto de extremidade de sondagem tem um dos quatro resultados, dependendo do status do trabalho de exclusão em massa. O resultado é fornecido dentro da resposta da OperationOutcome da FHIR

  1. Trabalhos em andamento: Este resultado indica que o trabalho está em andamento. Código de status 202
  2. Concluído: este resultado indica que o trabalho foi concluído com êxito. Após a conclusão, as informações do número de recursos excluídos seriam fornecidas no nível de tipo de recurso individual. Código de status 200
  3. Cancelado: esse resultado indica que o trabalho é cancelado pelo usuário e fornece informações sobre o número de recursos excluídos no nível de tipo de recurso individual. Código de status 200
  4. Falha: este resultado indica que o trabalho falhou. O código de status depende do tipo de falha.

Solicitação de amostra e resposta para determinar o status Solicitação:

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

Exemplo de resposta do trabalho de exclusão concluído com êxito.

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

Próximas etapas

Neste artigo, você aprendeu como excluir recursos em massa no serviço FHIR. Para obter informações sobre os recursos FHIR suportados, consulte

FHIR® é uma marca registrada da HL7 e é usado com a permissão da HL7.