Share via


Massenlöschung

Mit "$bulk löschen" können Sie Ressourcen asynchron vom FHIR-Server löschen. Massenlöschvorgang kann auf Systemebene oder für einzelne Ressourcentypen ausgeführt werden.

  • Systemebene: Die Ausführung des Vorgangs auf Systemebene ermöglicht das Löschen von FHIR-Ressourcen über alle Ressourcentypen im FHIR-Server hinweg.

      DELETE  /$bulkDelete
    
  • Einzelner Ressourcentyp: Die Ausführung des Vorgangs bei einzelnen Ressourcentypen ermöglicht das Löschen von FHIR-Ressourcen, die dem angegebenen Ressourcentyp in der URL zugeordnet sind.

      DELETE /<Resource Type>/$bulkDelete
    

Hinweis

Die Massenlöschung ist ein Vorgang, der mit Vorsicht verwendet werden kann. Ressourcen im FHIR-Dienst nach dem Löschen können nicht rückgängig machen werden.

Der Massenlöschvorgang befindet sich derzeit in der öffentlichen Vorschau. Überprüfen Sie den Haftungsausschluss für Details.

Wichtig

Vorschau-APIs und -SDKs werden ohne Vereinbarung zum Servicelevel bereitgestellt. Es wird empfohlen, diese nicht für Produktionsworkloads zu verwenden. Einige Features werden möglicherweise nicht unterstützt oder bieten nur eingeschränkte Funktionalität. Weitere Informationen finden Sie in den ergänzenden Nutzungsbestimmungen für Microsoft Azure-Vorschauversionen.

Kopfzeilen

Der Massenlöschvorgang erfordert zwei Headerparameter.

  • Accept: application/fhir+json
  • Prefer: respond-async

Abfrageparameter

Mit Abfrageparametern können Sie rohe Ressourcen filtern, die Sie löschen möchten. Zur Unterstützung der Filterung sind FHIR-Dienstabfrageparameter:

Query parameter (Abfrageparameter) Standardwert Beschreibung
_hardDelete False Übergeben Sie für das Löschen der Ressource einschließlich Verlaufsversion den Wert "true".
_purgeHistory False Ermöglicht das Löschen von Verlaufsversionen, die einer Ressource zugeordnet sind.
Unterstützte Suchparameter des FHIR-Diensts Ermöglicht das Angeben von Suchkriterien und Ressourcen, die den Suchkriterien entsprechen, gelöscht werden. Beispiel: adresse:contains=Wiese betreff:Patient.birthdate=1987-02-20

Alle Abfrageparameter sind optional.

antwort $bulk löschen

Nachdem die Anforderung zum Massenlöschen von FHIR-Ressourcen gestellt wurde, sollten Sie als Antwort den Content-Location-Header mit der absoluten URL eines Endpunkts für nachfolgende Statusanforderungen erhalten, z. B. einen Abrufendpunkt.

Abrufendpunkt: Die Anforderung an den Abrufendpunkt weist je nach Status des Massenlöschauftrags eines der vier Ergebnisse auf. Das Ergebnis wird in OperationOutcome der FHIR-Antwort bereitgestellt.

  1. Aufträge in Bearbeitung: Dieses Ergebnis gibt an, dass der Auftrag in Bearbeitung ist. Statuscode 202
  2. Abgeschlossen: Dieses Ergebnis gibt an, dass der Auftrag erfolgreich abgeschlossen wurde. Nach Abschluss werden die Informationen über die Anzahl der gelöschten Ressourcen auf einzelner Ressourcentypebene bereitgestellt. Statuscode 200
  3. Abgebrochen: Dieser Ergebnisstatusauftrag wird vom Benutzer abgebrochen und stellt Informationen zur Anzahl der Ressourcen bereit, die auf einzelner Ressourcentypebene gelöscht werden. Statuscode 200
  4. Fehler: Dieser Ergebnisstatusauftrag ist fehlgeschlagen. Statuscode hängt vom Fehlertyp ab.

Beispielanforderung und Antwort zur Ermittlung der Statusanforderung:

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

Beispielantwort des erfolgreich abgeschlossenen Löschauftrags.

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

Nächste Schritte

In diesem Artikel haben Sie erfahren, wie Sie Ressourcen im FHIR-Dienst massenlöschen. Informationen zu unterstützten FHIR-Features finden Sie unter

FHIR® ist eine eingetragene Marke von HL7 und wird mit Genehmigung von HL7 verwendet.