Partilhar via


Eliminação em Massa

'$bulk-delete' permite que você exclua 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
    

Nota

A exclusão em massa é uma operação a ser usada com cuidado. 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. Reveja a declaração de exoneração de responsabilidade para obter detalhes.

Importante

As APIs e SDKs de visualização são fornecidos sem um contrato de nível de serviço. Recomendamos que você não os use para cargas de trabalho de produção. Alguns recursos podem não ser suportados ou podem ter recursos restritos. Para obter mais informações, consulte Termos de Utilização Suplementares para Pré-visualizações do Microsoft Azure.

Cabeçalhos

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

  • Aceitar: application/fhir+json
  • Preferir: 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 de serviço FHIR são:

Parâmetro de consulta Valor Predefinido Descrição
_hardDelete False Para exclusão de recurso, incluindo a versão do histórico, passe o valor true.
_purgeHistory False 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 recursos correspondentes aos critérios de pesquisa são excluídos. Exemplo: address:contains=Meadow subject:Patient.birthdate=1987-02-20

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

Resposta $bulk-delete

Depois que a solicitação for feita para excluir recursos FHIR em massa, em resposta, você 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 votação: 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 of FHIR

  1. Trabalhos em curso: Este resultado indica que o trabalho está em curso. Código de status 202
  2. Concluído: Este resultado indica que o trabalho foi concluído com êxito. Após a conclusão, a informação do número de recursos suprimidos seria fornecida ao nível do tipo de recurso individual. Código de status 200
  3. Cancelado: este resultado indica que o trabalho é cancelado pelo usuário e fornece informações sobre o número de recursos excluídos no nível do 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.

Exemplo de solicitação e resposta para determinar a solicitação de status:

{{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óximos passos

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 registada da HL7 e é utilizada com a permissão da HL7 .