Funzionalità
L'API di Azure per FHIR offre una distribuzione completamente gestita del server Microsoft FHIR per Azure. Il server è un'implementazione dello standard FHIR . Questo documento elenca le funzionalità principali del server FHIR.
Versione di FHIR
Versione più recente supportata: 4.0.1
Le versioni precedenti attualmente supportate includono: 3.0.2
REST API
Di seguito è riportato un riepilogo delle funzionalità RESTful supportate. Per altre informazioni sull'implementazione di queste funzionalità, vedere Funzionalità dell'API REST FHIR.
| API | API di Azure per FHIR | Servizio FHIR in Servizi per i dati sanitari di Azure | Commento |
|---|---|---|---|
| lettura | Sì | Sì | |
| vread | Sì | Sì | |
| update | Sì | Sì | |
| aggiornamento con blocco ottimistico | Sì | Sì | |
| update (condizionale) | Sì | Sì | |
| Patch | Sì | Sì | Supporto solo per patch JSON e patch FHIRPath. |
| patch (condizionale) | Sì | Sì | Supporto solo per patch JSON e patch FHIRPath. |
| history | Sì | Sì | |
| create | Sì | Sì | Supportare sia POST/PUT |
| create (condizionale) | Sì | Sì | Problema 1382 |
| search | Partial | Partial | Vedere Panoramica della ricerca FHIR. |
| ricerca concatenata | Sì | Sì | Vedi la Nota di seguito. |
| ricerca concatenata inversa | Sì | Sì | Vedi la Nota di seguito. |
| batch | Sì | Sì | |
| transazione | No | Sì | |
| paging | Partial | Partial | self e next sono supportati |
| Intermediari | No | Numero |
Nota
Nell'API di Azure per FHIR e nel server FHIR open source supportato da Azure Cosmos DB, la ricerca concatenato e la ricerca con concatenata inversa è un'implementazione MVP. Per eseguire una ricerca concatenata in Azure Cosmos DB, l'implementazione descrive l'espressione di ricerca e rilascia le sottoquery per risolvere le risorse corrispondenti. Questa operazione viene eseguita per ogni livello dell'espressione. Se una query restituisce più di 1000 risultati, verrà generato un errore.
Operazioni estese
Tutte le operazioni supportate che estendono l'API REST.
| Tipo di parametro di ricerca | API di Azure per FHIR | Servizio FHIR in Servizi per i dati sanitari di Azure | Commento |
|---|---|---|---|
| $export | Sì | Sì | Supporta sistema, gruppo e paziente. |
| $convert-data | Sì | Sì | |
| $validate | Sì | Sì | |
| $member-match | Sì | Sì | |
| $patient-tutto | Sì | Sì | |
| cronologia $purge | Sì | Sì |
Persistenza
Microsoft FHIR Server dispone di un modulo di persistenza collegabile (vedere Microsoft.Health.Fhir.Core.Features.Persistence).
Attualmente il codice open source del server FHIR include un'implementazione per Azure Cosmos DB e database SQL.
Azure Cosmos DB è un database multimodello distribuito a livello globale (NoSQL, MongoDB e altri). Supporta livelli di coerenza diversi. Il modello di distribuzione predefinito configura il server FHIR con Strong coerenza, ma i criteri di coerenza possono essere modificati (in genere rilassato) su una richiesta usando l'intestazione della x-ms-consistency-level richiesta.
Controllo degli accessi in base al ruolo
Il server FHIR usa Microsoft Entra ID per il controllo di accesso. In particolare, viene applicato il controllo degli accessi in base al ruolo, se il FhirServer:Security:Enabled parametro di configurazione è impostato su truee tutte le richieste (ad eccezione /metadatadi ) nel server FHIR devono avere Authorization l'intestazione della richiesta impostata su Bearer <TOKEN>. Il token deve contenere uno o più ruoli, come definito nell'attestazione roles . Una richiesta sarà consentita se il token contiene un ruolo che consente l'azione specificata sulla risorsa specificata.
Attualmente, le azioni consentite per un determinato ruolo vengono applicate a livello globale nell'API.
Limiti del servizio
Unità richiesta (UR): è possibile configurare fino a 100.000 UR nel portale per l'API di Azure per FHIR. Sono necessarie almeno 400 UR o 40 UR/GB, a qualsiasi livello di dimensioni maggiori. Se sono necessarie più di 100.000 UR, è possibile inserire un ticket di supporto per aumentare le UR. Il valore massimo disponibile è 1.000.000. Inoltre, è supportata la scalabilità automatica delle UR.
Dimensioni bundle: ogni bundle è limitato a 500 elementi.
Dimensioni dei dati: i dati o i documenti devono essere leggermente inferiori a 2 MB.
Limite di sottoscrizioni: per impostazione predefinita, ogni sottoscrizione è limitata a un massimo di 10 istanze del server FHIR. Se sono necessarie più istanze per sottoscrizione, aprire un ticket di supporto e fornire informazioni dettagliate sulle esigenze.
Dimensioni delle risorse: le singole dimensioni delle risorse, inclusa la cronologia, non devono superare i 20 GB.
Passaggi successivi
In questo articolo sono state fornite informazioni sulle funzionalità FHIR supportate nell'API di Azure per FHIR. Per informazioni sulla distribuzione dell'API di Azure per FHIR, vedere
FHIR® è un marchio registrato di HL7 e viene usato con l'autorizzazione di HL7.