Funkcje
Usługa Azure API for FHIR® zapewnia w pełni zarządzane wdrożenie serwera Microsoft FHIR dla platformy Azure. Serwer jest implementacją standardu FHIR . Ten dokument zawiera listę głównych funkcji serwera FHIR.
Wersja FHIR
Obsługiwana najnowsza wersja: 4.0.1
Poprzednie wersje są również obecnie obsługiwane: 3.0.2
Interfejs API REST
Poniżej przedstawiono podsumowanie obsługiwanych funkcji RESTful. Aby uzyskać więcej informacji na temat implementacji tych funkcji, zobacz FHIR REST API capabilities (Możliwości interfejsu API REST FHIR).
| interfejs API | Interfejs API platformy Azure dla standardu FHIR | Usługa FHIR w Azure Health Data Services | Komentarz |
|---|---|---|---|
| odczyt | Tak | Tak | |
| vread | Tak | Tak | |
| update | Tak | Tak | |
| aktualizacja z optymistycznym blokowaniem | Tak | Tak | |
| aktualizacja (warunkowa) | Tak | Tak | |
| łata | Tak | Tak | Obsługa tylko poprawek JSON i poprawki FHIRPath. |
| patch (warunkowe) | Tak | Tak | Obsługa tylko poprawek JSON i poprawki FHIRPath. |
| historia | Tak | Tak | |
| create | Tak | Tak | Obsługa funkcji POST/PUT |
| tworzenie (warunkowe) | Tak | Tak | Problem nr 1382 |
| search | Częściowe | Częściowe | Zobacz Omówienie wyszukiwania FHIR. |
| wyszukiwanie łańcuchowe | Tak | Tak | Zobacz następującą uwagę. |
| wyszukiwanie odwrotne łańcuchowe | Tak | Tak | Zobacz następującą uwagę. |
| batch | Tak | Tak | |
| transakcja | Nie. | Tak | |
| stronicowanie | Częściowe | Częściowe | self i next są obsługiwane |
| Pośredników | Nie | Nr |
Uwaga
W usłudze Azure API for FHIR i serwerze open source FHIR wspieranym przez usługę Azure Cosmos DB łańcuchowe wyszukiwanie i wyszukiwanie odwrotne jest implementacją MVP. Aby wykonać wyszukiwanie łańcuchowe w usłudze Azure Cosmos DB, implementacja przechodzi w dół wyrażenia wyszukiwania i problemów podrzędnych w celu rozwiązania dopasowanych zasobów. Odbywa się to dla każdego poziomu wyrażenia. Jeśli jakiekolwiek zapytanie zwraca więcej niż 1000 wyników, zostanie zgłoszony błąd.
Operacje rozszerzone
Wszystkie obsługiwane operacje rozszerzające interfejs API REST.
| Typ parametru wyszukiwania | Interfejs API platformy Azure dla standardu FHIR | Usługa FHIR w Azure Health Data Services | Komentarz |
|---|---|---|---|
| $export | Tak | Tak | Obsługuje system, grupę i pacjenta. |
| $convert-data | Tak | Tak | |
| $validate | Tak | Tak | |
| $member-match | Tak | Tak | |
| $patient wszystko | Tak | Tak | |
| $purge-history | Tak | Tak |
Trwałość
Serwer Microsoft FHIR ma podłączony moduł trwałości (zobacz Microsoft.Health.Fhir.Core.Features.Persistence).
Obecnie kod open source serwera FHIR zawiera implementację usług Azure Cosmos DB i SQL Database.
Azure Cosmos DB to globalnie rozproszona wielomodelowa baza danych (NoSQL, MongoDB i inne). Obsługuje różne poziomy spójności. Domyślny szablon wdrożenia konfiguruje serwer FHIR ze spójnością Strong , ale zasady spójności można modyfikować (ogólnie złagodzone) na żądanie przy użyciu nagłówka x-ms-consistency-level żądania.
Kontrola dostępu oparta na rolach
Serwer FHIR używa identyfikatora Microsoft Entra ID do kontroli dostępu. W szczególności kontrola dostępu oparta na rolach (RBAC) jest wymuszana, jeśli FhirServer:Security:Enabled parametr konfiguracji jest ustawiony na true, a wszystkie żądania (z wyjątkiem /metadata) do serwera FHIR muszą mieć Authorization nagłówek żądania ustawiony na Bearer <TOKEN>wartość . Token musi zawierać co najmniej jedną rolę zdefiniowaną w oświadczeniu roles . Żądanie jest dozwolone, jeśli token zawiera rolę, która zezwala na określoną akcję dla określonego zasobu.
Obecnie dozwolone akcje dla danej roli są stosowane globalnie w interfejsie API.
Limity usługi
Jednostki żądań (RU) — w portalu dla usługi Azure API for FHIR można skonfigurować maksymalnie 100 000 jednostek RU. Potrzebujesz co najmniej 400 jednostek RU lub 40 jednostek RU/GB, w zależności od tego, co jest większe. Jeśli potrzebujesz więcej niż 100 000 jednostek RU, możesz umieścić bilet pomocy technicznej, aby zwiększyć liczbę jednostek RU. Maksymalna dostępna wartość to 1000 000. Ponadto obsługujemy skalowanie automatyczne jednostek RU.
Rozmiar pakietu — każdy pakiet jest ograniczony do 500 elementów.
Rozmiar danych — dane/dokumenty muszą być mniejsze niż 2 MB.
Limit subskrypcji — domyślnie każda subskrypcja jest ograniczona do maksymalnie 10 wystąpień serwera FHIR. Jeśli potrzebujesz więcej wystąpień na subskrypcję, otwórz bilet pomocy technicznej i podaj szczegółowe informacje o swoich potrzebach.
Rozmiar zasobu — rozmiar pojedynczego zasobu, w tym historia, nie powinien przekraczać 20 GB.
Następne kroki
W tym artykule zapoznasz się z obsługiwanymi funkcjami FHIR w usłudze Azure API for FHIR. Aby uzyskać informacje o wdrażaniu usługi Azure API for FHIR, zobacz
Uwaga
FHIR® jest zastrzeżonym znakiem towarowym HL7 i jest używany z uprawnieniem HL7.