Ricerca di risorse FHIR con GET - AWS HealthLake
GET: esempi di ricerca

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Ricerca di risorse FHIR con GET

È possibile utilizzare GET le richieste per effettuare ricerche in un archivio HealthLake dati. Durante l'utilizzoGET, HealthLake supporta la fornitura di parametri di ricerca come parte dell'URL, ma non come parte del corpo della richiesta. Per ulteriori informazioni, consulta Parametri di ricerca FHIR R4 per HealthLake.

Importante

Per le ricerche che coinvolgono informazioni di identificazione personale (PII) o informazioni sanitarie protette (PHI), le migliori pratiche di sicurezza richiedono l'utilizzo delle POST richieste, poiché PII e PHI vengono aggiunti come parte del corpo della richiesta e vengono crittografati durante il transito. Per ulteriori informazioni, consulta Ricerca di risorse FHIR con POST.

La procedura seguente è seguita da esempi da utilizzare GET per effettuare ricerche in un archivio dati. HealthLake

Per effettuare ricerche in un HealthLake data store con GET

  1. Raccogli HealthLake region e datastoreId valorizza. Per ulteriori informazioni, consulta Ottenere le proprietà dell'archivio dati.

  2. Determina il tipo di risorsa FHIR da cercare e raccogliere il id valore associato. Per ulteriori informazioni, consulta Tipi di risorsa.

  3. Costruisci un URL per la richiesta utilizzando i valori raccolti per HealthLake region e. datastoreId Includi anche il Resource tipo FHIR e i parametri di ricerca supportati. Per visualizzare l'intero percorso dell'URL nell'esempio seguente, scorri il pulsante Copia.

    GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource{?[parameters]{&_format=[mime-type]}}

  4. Invia la GET richiesta con l'autorizzazione AWS Signature Version 4 o SMART on FHIR. L'curlesempio seguente restituisce il numero totale di Patient risorse in un archivio HealthLake dati. Per visualizzare l'intero esempio, scorri il pulsante Copia.

    SigV4

    Autorizzazione SIGv4

    curl --request GET \
  'https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?_total=accurate' \   
  --aws-sigv4 'aws:amz:region:healthlake' \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  --header "x-amz-security-token:$AWS_SESSION_TOKEN" \                          
  --header 'Accept: application/json'
    SMART on FHIR

    Esempio di autorizzazione SMART on FHIR per il tipo di dati IdentityProviderConfiguration.

    {
    "AuthorizationStrategy": "SMART_ON_FHIR",
    "FineGrainedAuthorizationEnabled": true,
    "IdpLambdaArn": "arn:aws:lambda:your-region:your-account-id:function:your-lambda-name",
    "Metadata": "{\"issuer\":\"https://ehr.example.com\", \"jwks_uri\":\"https://ehr.example.com/.well-known/jwks.json\",\"authorization_endpoint\":\"https://ehr.example.com/auth/authorize\",\"token_endpoint\":\"https://ehr.token.com/auth/token\",\"token_endpoint_auth_methods_supported\":[\"client_secret_basic\",\"foo\"],\"grant_types_supported\":[\"client_credential\",\"foo\"],\"registration_endpoint\":\"https://ehr.example.com/auth/register\",\"scopes_supported\":[\"openId\",\"profile\",\"launch\"],\"response_types_supported\":[\"code\"],\"management_endpoint\":\"https://ehr.example.com/user/manage\",\"introspection_endpoint\":\"https://ehr.example.com/user/introspect\",\"revocation_endpoint\":\"https://ehr.example.com/user/revoke\",\"code_challenge_methods_supported\":[\"S256\"],\"capabilities\":[\"launch-ehr\",\"sso-openid-connect\",\"client-public\",\"permission-v2\"]}"
}

    Il chiamante può assegnare le autorizzazioni nella lambda di autorizzazione. Per ulteriori informazioni, consulta OAuth Cannocchiali 2.0.

    AWS Console
    Nota

    La HealthLake console supporta solo l'autorizzazione SigV4. L'autorizzazione SMART on FHIR è supportata tramite e. AWS CLI AWS SDKs

    1. Accedi alla pagina Esegui interrogazione sulla HealthLake console.

    2. Nella sezione Impostazioni della query, effettua le seguenti selezioni.

    • Data Store ID: scegli un ID del data store per generare una stringa di query.

    • Tipo di query: scegliSearch with GET.

    • Tipo di risorsa: scegli il tipo di risorsa FHIR su cui eseguire la ricerca.

    • Parametri di ricerca: seleziona un parametro di ricerca o una combinazione di parametri di ricerca per concentrare la ricerca su record specifici.

    3. Scegli Esegui query.

Esempi: ricerca con GET

Le schede seguenti forniscono esempi per la ricerca su tipi di risorse FHIR specifici con. GET Gli esempi mostrano come specificare i parametri di ricerca nella richiesta. URLs

Nota

La HealthLake console supporta solo l'autorizzazione SigV4. L'autorizzazione SMART on FHIR è supportata tramite e. AWS CLI AWS SDKs

HealthLake supporta un sottoinsieme di parametri di ricerca FHIR R4. Per ulteriori informazioni, consulta Parametri di ricerca.

Patient (age)

Sebbene l'età non sia un tipo di risorsa definito in FHIR, viene acquisita come elemento del tipo di risorsa. Patient Utilizzate l'esempio seguente per effettuare una richiesta di ricerca GET basata sui tipi di Patientrisorse utilizzando l'elemento BirthDate e il eq comparatore di ricerca per cercare individui nati nel 1997.

GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?birthdate=eq1997
Condition

Utilizzate l'esempio seguente per effettuare una GET richiesta sul tipo di Conditionrisorsa. La ricerca trova le condizioni nell'archivio HealthLake dati che contengono il codice medico SNOMED72892002, che si traduce in. Normal pregnancy

GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Condition?code=72892002
DocumentationReference

L'esempio seguente mostra come creare una GET richiesta sul tipo di DocumentReferencerisorsa per Patient una o più persone con diagnosi di streptococco e a cui è stata prescritta anche amoxicillina.

GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/DocumentReference?_lastUpdated=le2021-12-19&infer-icd10cm-entity-text-concept-score;=streptococcal|0.6&infer-rxnorm-entity-text-concept-score=Amoxicillin|0.8
Location

Utilizzate l'esempio seguente per effettuare una richiesta sul tipo di risorsa. GET Location La ricerca seguente trova le posizioni nel tuo archivio HealthLake dati che contengono il nome della città Boston come parte dell'indirizzo.

GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Location?address=boston
Observation

Utilizza l'esempio seguente per effettuare una richiesta di ricerca GET basata sul tipo di Observationrisorsa. Questa ricerca utilizza il parametro value-concept di ricerca per cercare il codice medico266919005, che si traduce inNever smoker.

GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation?value-concept=266919005