Features
Azure API for FHIR bietet eine vollständig verwaltete Bereitstellung des Microsoft FHIR-Servers für Azure. Der Server ist eine Implementierung des FHIR-Standards. In diesem Dokument sind die wichtigsten Features des FHIR-Servers aufgeführt.
FHIR-Version
Letzte unterstützte Version: 4.0.1
Derzeit ebenfalls unterstützte vorherige Versionen: 3.0.2
REST-API
Nachfolgend finden Sie eine Zusammenfassung der unterstützten RESTful-Funktionen. Weitere Informationen zur Implementierung dieser Funktionen finden Sie unter FHIR-REST-API-Funktionen.
| API | Azure API for FHIR | FHIR-Dienst in Azure Health Data Services | Kommentar |
|---|---|---|---|
| Lesen | Ja | Ja | |
| vread | Ja | Ja | |
| aktualisieren | Ja | Ja | |
| Update mit optimistischer Sperre | Ja | Ja | |
| update (bedingt) | Ja | Ja | |
| patch | Ja | Ja | Unterstützung nur für JSON-Patch und FHIRPath-Patch. |
| Patch (bedingt) | Ja | Ja | Unterstützung nur für JSON-Patch und FHIRPath-Patch. |
| history | Ja | Ja | |
| create | Ja | Ja | Unterstützung für POST/PUT |
| create (bedingt) | Ja | Ja | Issue #1382 |
| search | Teilweise | Partial | Siehe Übersicht über die FHIR-Suche. |
| Verkettete Suche | Ja | Ja | Siehe Hinweise unten. |
| Umgekehrte verkettete Suche | Ja | Ja | Siehe Hinweise unten. |
| batch | Ja | Ja | |
| Transaktion | No | Ja | |
| paging | Teilweise | Partial | self und next werden unterstützt |
| intermediaries | No | Nein |
Hinweis
In Azure API for FHIR und im auf Azure Cosmos DB basierenden Open-Source-FHIR-Server sind die verkettete Suche und die umgekehrte verkettete Suche eine MVP-Implementierung. Um die verkettete Suche in Azure Cosmos DB durchzuführen, durchläuft die Implementierung den Suchausdruck von oben nach unten und sendet Unterabfragen, um die übereinstimmenden Ressourcen aufzulösen. Dies erfolgt für jede Ebene des Ausdrucks. Wenn eine Abfrage mehr als 1000 Ergebnisse zurückgibt, wird ein Fehler ausgelöst.
Erweiterte Vorgänge
Alle unterstützten Vorgänge zur Erweiterung der REST-API.
| Suchparametertyp | Azure API for FHIR | FHIR-Dienst in Azure Health Data Services | Kommentar |
|---|---|---|---|
| $export | Ja | Ja | Unterstützt System, Gruppe und Patient. |
| $convert-Daten | Ja | Ja | |
| $validate | Ja | Ja | |
| $member-match | Ja | Ja | |
| $patient-everything | Ja | Ja | |
| $purge-history | Ja | Ja |
Persistenz
Der Microsoft FHIR-Server verfügt über ein austauschbares Persistenzmodul (siehe Microsoft.Health.Fhir.Core.Features.Persistence).
Derzeit umfasst der Open-Source-Code für FHIR-Server eine Implementierung für Azure Cosmos DB und SQL-Datenbank.
Azure Cosmos DB ist eine global verteilte Datenbank mit mehreren Modellen (NoSQL, MongoDB und andere). Es unterstützt verschiedene Konsistenzebenen. Die standardmäßige Bereitstellungsvorlage konfiguriert den FHIR-Server mit Strong-Konsistenz, aber die Konsistenzrichtlinie kann auf Anforderungsbasis unter Verwendung des Anforderungsheaders x-ms-consistency-level geändert (allgemein gelockert) werden.
Rollenbasierte Zugriffssteuerung
Der FHIR Server verwendet Die Microsoft Entra-ID für die Zugriffssteuerung. Insbesondere wird die rollenbasierte Zugriffssteuerung (Role-Based Access Control, RBAC) erzwungen, wenn der Konfigurationsparameter FhirServer:Security:Enabled auf true festgelegt ist, und bei allen Anforderungen (außer /metadata) an den FHIR-Server muss der Anforderungsheader Authorization auf Bearer <TOKEN> festgelegt sein. Das Token muss eine oder mehrere Rollen gemäß der Definition im roles-Anspruch enthalten. Eine Anforderung ist zulässig, wenn der Token eine Rolle enthält, die die angegebene Aktion für die angegebene Ressource gestattet.
Derzeit werden die zulässigen Aktionen für eine bestimmte Rolle global auf die API angewendet.
Diensteinschränkungen
Anforderungseinheiten (RUs) – Sie können bis zu 100.000 RUs im Portal für azure-API für FHIR konfigurieren. Sie benötigen mindestens 400 RUs oder 40 RUs/GB, je nachdem, welcher Wert größer ist. Wenn Sie mehr als 100.000 RUs benötigen, können Sie ein Supportticket einfügen, damit die RUs erhöht werden. Maximal sind 1.000.000 RUs verfügbar. Darüber hinaus unterstützen wir die automatische Skalierung von RUs.
Paketgröße: Jedes Paket ist auf 500 Elemente beschränkt.
Datengröße: Daten/Dokumente müssen jeweils etwas kleiner als 2 MB sein.
Grenzwert für Abonnements – Standardmäßig ist jedes Abonnement auf maximal 10 FHIR-Serverinstanzen beschränkt. Wenn Sie mehr Instanzen pro Abonnement benötigen, öffnen Sie ein Supportticket und geben Sie Details zu Ihren Anforderungen an.
Ressourcengröße – Einzelne Ressourcengröße einschließlich Verlauf sollte 20 GB nicht überschreiten.
Nächste Schritte
In diesem Artikel haben Sie Informationen zu den unterstützten FHIR-Features in Azure API for FHIR erhalten. Informationen zum Bereitstellen der Azure-API für FHIR finden Sie unter
FHIR® ist eine eingetragene Marke von HL7 und wird mit Genehmigung von HL7 verwendet.