Massradering

  • Artikel

Med "$bulk-delete" kan du ta bort resurser från FHIR-servern asynkront. Massborttagningsåtgärden kan köras på systemnivå eller för enskilda resurstyper.

  • Systemnivå: Körning av åtgärden på systemnivå möjliggör borttagning av FHIR-resurser över alla resurstyper i FHIR-servern.

      DELETE  /$bulkDelete

  • Enskild resurstyp: Körning av åtgärden vid enskilda resurstyper tillåter borttagning av FHIR-resursmappning till angiven resurstyp i URL:en.

      DELETE /<Resource Type>/$bulkDelete

Kommentar

Massborttagning är en åtgärd som ska användas med försiktighet. Resurser i FHIR-tjänsten när de har tagits bort kan inte återställas.

Massborttagningsåtgärden är för närvarande i offentlig förhandsversion. Mer information finns i ansvarsfriskrivningen.

Viktigt!

Förhandsversions-API:er och SDK:er tillhandahålls utan ett serviceavtal. Vi rekommenderar att du inte använder dem för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds, eller så kan de ha begränsade funktioner. Mer information finns i Kompletterande användningsvillkor för Förhandsversioner av Microsoft Azure.

Sidhuvuden

Massborttagningsåtgärden kräver två rubrikparametrar

  • Acceptera: application/fhir+json
  • Föredrar: svara-asynkron

Frågeparametrar

Med frågeparametrar kan du filtrera rådata som du tänker ta bort. FHIR-tjänstfrågeparametrar stöder filtrering:

Frågeparameter Standardvärde Description
_hardDelete Falsk För borttagning av resurs inklusive historikversion, skicka värdet true.
_purgeHistory Falsk Tillåter att historikversioner som är associerade med resursen tas bort.
Sökparametrar som stöds av FHIR-tjänsten Tillåter att du anger sökvillkor och resurser som matchar sökvillkoren tas bort. Exempel: address:contains=Meadow subject:Patient.birthdate=1987-02-20

Alla frågeparametrar är valfria.

$bulk-ta bort svar

När begäran har gjorts om massborttagning av FHIR-resurser bör du som svar få rubriken Content-Location med den absoluta URL:en för en slutpunkt för efterföljande statusbegäranden, till exempel en slutpunkt för avsökning.

Slutpunkt för avsökning: Begäran till slutpunkten för avsökning har ett av de fyra resultaten beroende på status för massborttagningsjobbet. Resultatet tillhandahålls i OperationOutcome för FHIR-svaret

  1. Pågående jobb: Det här resultatet anger att jobbet pågår. Statuskod 202
  2. Slutfört: Det här resultatet anger att jobbet har slutförts. När det är klart tillhandahålls information om antalet borttagna resurser på enskild resurstypsnivå. Statuskod 200
  3. Avbrutet: Det här resultatet anger att jobbet avbryts av användaren och innehåller information om hur många resurser som tas bort på enskild resurstypsnivå. Statuskod 200
  4. Misslyckades: Det här resultatet anger att jobbet har misslyckats. Statuskod beror på feltyp.

Exempelbegäran och svar för att fastställa statusbegäran:

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

Exempelsvar på slutfört borttagningsjobb.

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

Nästa steg

I den här artikeln har du lärt dig hur du massar bort resurser i FHIR-tjänsten. Information om FHIR-funktioner som stöds finns i

FHIR-funktioner som stöds

FHIR REST API-funktioner för Azure Health Data Services FHIR-tjänsten

FHIR® är ett registrerat varumärke som tillhör HL7 och används med tillstånd av HL7.