Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Löschen einer FHIR-Ressource

Die delete FHIR-Interaktion entfernt eine vorhandene FHIR-Ressource aus einem HealthLake Datenspeicher. Weitere Informationen finden Sie delete in der FHIR R4 RESTful API-Dokumentation.

Um eine FHIR-Ressource zu löschen

Löschen von FHIR-Ressourcen auf der Grundlage von Bedingungen

Bedingtes Löschen ist besonders nützlich, wenn Sie die spezifische FHIR-Ressourcen-ID nicht kennen, aber über andere identifizierende Informationen zu der Ressource verfügen, die Sie löschen möchten.

Bedingtes Löschen ermöglicht es Ihnen, eine vorhandene Ressource anhand von Suchkriterien und nicht anhand der logischen FHIR-ID zu löschen. Wenn der Server die Löschanforderung verarbeitet, führt er mithilfe von Standardsuchfunktionen eine Suche nach dem Ressourcentyp durch, um eine einzelne logische ID für die Anforderung aufzulösen.

So funktioniert bedingtes Löschen

Die Aktion des Servers hängt davon ab, wie viele Treffer er findet:

Antwortszenarien

AWS HealthLake verarbeitet bedingte Löschvorgänge mit den folgenden Antwortmustern:

Erfolgreiche Operationen

ID-Based Bedingtes Löschen

Beim Ausführen eines bedingten Löschens auf der id Grundlage zusätzlicher Parameter (createdAt_tag, oder_lastUpdated):

Non-ID-Based Bedingtes Löschen

Wann id wird nicht angegeben oder wenn andere Parameter alscreatedAt,_tag, oder verwendet werden_lastUpdated:

Konfliktsituationen

Verschiedene Szenarien führen zu 412 Antworten auf „Vorbedingung fehlgeschlagen“:

Beispiel für ein erfolgreiches bedingtes Löschen

Im folgenden Beispiel wird eine Patientenressource anhand bestimmter Kriterien gelöscht:

DELETE https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?name=peter&birthdate=2000-01-01&phone=1234567890

Diese Anfrage löscht eine Patientenressource, in der:

Bewährte Methoden

Löschen mehrerer FHIR-Ressourcen in einer Anfrage mit _count

Standardmäßig erfordert ein bedingtes Löschen, dass Ihre Suchkriterien genau einer Ressource entsprechen. Um mehrere übereinstimmende Ressourcen in einer einzigen Anfrage zu löschen, geben Sie den _count Abfrageparameter ein. Wenn er vorhanden _count ist, wird die Anforderung als Batchvorgang HealthLake verarbeitet. Es sucht nach passenden Ressourcen, löscht sie und gibt HTTP 200 mit einem FHIR vom Typ zurückbatch-response, Bundle der einen ressourcenspezifischen Status enthält.

Beispielanforderung

Die folgende Anfrage löscht passende markierte Coverage Ressourcen: inactive

DELETE https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Coverage?_tag=inactive&_count=50

Format der Batch-Antwort

Eine Anforderung, die HTTP 200 mit einem enthält, _count gibt HTTP zurück batch-responseBundle. Jeder Eintrag gibt das Ergebnis für eine übereinstimmende Ressource an:

Wie bei jeder FHIR-Suche folgt die Reihenfolge, in der Ressourcen zugeordnet und gelöscht werden, der Reihenfolge der zugrunde liegenden Suchergebnisse. Die Suche garantiert diese Reihenfolge nicht, es sei denn, Sie nehmen den _sort Parameter in Ihre Suchkriterien auf. Wenn Sie eine deterministische Reihenfolge bei paginierten Batch-Löschungen benötigen, geben Sie Folgendes an. _sort Weitere Informationen finden Sie unter Suchparameter.

In der Antwort Bundle ist die Reihenfolge der Eingaben ebenfalls nicht garantiert. Ordnen Sie jeden Eintrag seiner Ressource zu, indem Sie das location Feld in dem Eintrag verwendenresponse, anstatt sich auf die Position des Eintrags zu verlassen.

Teilweiser Erfolg (Versionskonflikt)

Eine Ressource kann zwischen der Suche und dem Löschen geändert werden. Erfolgreich gelöschte Ressourcen kehren zurück204; widersprüchliche Ressourcen werden 412 in derselben Bundle Datei zurückgegeben.

{
  "resourceType": "Bundle",
  "type": "batch-response",
  "entry": [
    {
      "response": {
        "status": "204",
        "location": "Coverage/b807f9ff-2872-45df-9325-0b2efe42e554"
      }
    },
    {
      "response": {
        "status": "412",
        "location": "Coverage/5287b322-d7e5-4688-bd55-022067db4d0f",
        "outcome": {
          "resourceType": "OperationOutcome",
          "issue": [
            {
              "severity": "error",
              "code": "exception",
              "diagnostics": "Resource was modified by another operation. Retry the request."
            }
          ]
        }
      }
    }
  ]
}

Löschen weiterer Treffer mit Paginierung

Eine einzelne Anfrage löscht höchstens eine Seite mit Treffern. Wenn mehr passende Ressourcen übrig sind, Bundle enthält die Antwort eine link mit einer next Beziehung und einer URL. Senden Sie eine DELETE HTTP-Anfrage an diese URL, um die nächste Seite zu löschen, und wiederholen Sie den Vorgang, bis die Antwort keinen next Link mehr enthält. Dem next Link muss gefolgt werden DELETE (dieselbe Methode wie bei der ursprünglichen Anfrage), nichtGET.

{
  "resourceType": "Bundle",
  "type": "batch-response",
  "link": [
    {
      "relation": "next",
      "url": "https://healthlake.us-east-1.amazonaws.com/...<page_token>"
    }
  ],
  "entry": [
    {
      "response": {
        "status": "204",
        "location": "Patient/4aeffdc9-6ac5-46ff-be10-bf8bd74dfecc"
      }
    }
  ]
}

SMART zum Verhalten bei der FHIR-Autorisierung

Weitere Hinweise zur Konfiguration von SMART mit FHIR-Autorisierung finden Sie unterSMART auf FHIR.

Wie gelten Servicekontingente

Für bedingtes Löschen im Batch-Modus gibt es kein eigenes Dienstkontingent. Jede Anfrage nutzt dieselben vorhandenen HealthLake Kontingente wie die von ihr ausgeführten Such- und Löschvorgänge, sodass eine einzelne Anfrage mehrere Kontingenteinheiten verbraucht:

Der Durchsatz hängt von der Schreibkapazität Ihres Datenspeichers ab. Um den Durchsatz innerhalb der Kontingentgrenzen Ihres Kontos zu verwalten, stellen Sie entweder mehr Anfragen mit einem kleineren _count Wert oder verwenden Sie eine engere Suche mit einem größeren _count Wert. Die aktuellen Kapazitätsbeschränkungen Ihres Kontos für Suchen und Schreiben finden Sie unterEndpunkte und Kontingente.

Überlegungen