FHIR-Ressourcen mit GET durchsuchen - AWS HealthLake
GET-Suchbeispiele

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.

FHIR-Ressourcen mit GET durchsuchen

Sie können GET Anfragen verwenden, um einen HealthLake Datenspeicher zu durchsuchen. HealthLake Unterstützt bei der Verwendung GET die Angabe von Suchparametern als Teil der URL, jedoch nicht als Teil eines Anforderungstexts. Weitere Informationen finden Sie unter FHIR R4-Suchparameter für HealthLake.

Wichtig

Bei Suchanfragen, die personenbezogene Daten (PII) oder geschützte Gesundheitsinformationen (PHI) beinhalten, empfehlen bewährte Sicherheitsverfahren die Verwendung von POST Anfragen, da PII und PHI als Teil des Anfragetexts hinzugefügt und bei der Übertragung verschlüsselt werden. Weitere Informationen finden Sie unter FHIR-Ressourcen mit POST durchsuchen.

Auf das folgende Verfahren folgen Beispiele, die GET zum Durchsuchen eines HealthLake Datenspeichers verwendet werden.

Um einen HealthLake Datenspeicher zu durchsuchen mit GET

  1. Sammeln HealthLake region und datastoreId Werte. Weitere Informationen finden Sie unter Eigenschaften des Datenspeichers abrufen.

  2. Ermitteln Sie den Typ der FHIR-Ressource, nach der gesucht werden soll, und erfassen Sie den zugehörigen id Wert. Weitere Informationen finden Sie unter Ressourcentypen.

  3. Konstruieren Sie mithilfe der gesammelten Werte für HealthLake region und datastoreId eine URL für die Anfrage. Geben Sie auch den Resource FHIR-Typ und die unterstützten Suchparameter an. Scrollen Sie über die Schaltfläche Kopieren, um den gesamten URL-Pfad im folgenden Beispiel anzuzeigen.

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

  4. Senden Sie die GET Anfrage entweder mit AWS Signature Version 4 oder SMART bei FHIR-Autorisierung. Das folgende curl Beispiel gibt die Gesamtzahl der Patient Ressourcen in einem HealthLake Datenspeicher zurück. Scrollen Sie über die Schaltfläche Kopieren, um das gesamte Beispiel anzuzeigen.

    SigV4

    SigV4-Autorisierung

    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

    SMART on FHIR-Autorisierungsbeispiel für den IdentityProviderConfigurationDatentyp.

    {
    "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\"]}"
}

    Der Anrufer kann im Autorisierungs-Lambda Berechtigungen zuweisen. Weitere Informationen finden Sie unter OAuth 2.0-Bereiche.

    AWS Console
    Anmerkung

    Die HealthLake Konsole unterstützt nur die SigV4-Autorisierung. Die SMART-on-FHIR-Autorisierung wird über AWS CLI und unterstützt. AWS SDKs

    1. Melden Sie sich auf der Seite „Abfrage ausführen“ in der HealthLake Konsole an.

    2. Treffen Sie im Abschnitt Abfrageeinstellungen die folgenden Optionen.

    • Datenspeicher-ID — Wählen Sie eine Datenspeicher-ID aus, um eine Abfragezeichenfolge zu generieren.

    • Abfragetyp — wählen SieSearch with GET.

    • Ressourcentyp — Wählen Sie den FHIR-Ressourcentyp aus, nach dem gesucht werden soll.

    • Suchparameter — Wählen Sie einen Suchparameter oder eine Kombination von Suchparametern aus, um Ihre Anfrage auf bestimmte Datensätze zu konzentrieren.

    3. Wählen Sie Abfrage ausführen.

Beispiele: Suche mit GET

Die folgenden Registerkarten enthalten Beispiele für die Suche nach bestimmten FHIR-Ressourcentypen mit. GET Die Beispiele zeigen, wie Suchparameter in der Anfrage URLs angegeben werden.

Anmerkung

Die HealthLake Konsole unterstützt nur die SigV4-Autorisierung. Die SMART-on-FHIR-Autorisierung wird über AWS CLI und unterstützt. AWS SDKs

HealthLake unterstützt eine Teilmenge der FHIR R4-Suchparameter. Weitere Informationen finden Sie unter Suchparameter.

Patient (age)

Obwohl das Alter in FHIR kein definierter Ressourcentyp ist, wird es als Element im Ressourcentyp erfasst. Patient Verwenden Sie das folgende Beispiel, um eine auf PatientRessourcentypen GET basierende Suchanfrage zu stellen, indem Sie das Element BirthDate und den eq Suchkomparator verwenden, um nach Personen zu suchen, die im Jahr 1997 geboren wurden.

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

Verwenden Sie das folgende Beispiel, um eine GET Anfrage für den ConditionRessourcentyp zu stellen. Bei der Suche werden Bedingungen in Ihrem HealthLake Datenspeicher gefunden, die den medizinischen Code von SNOMED enthalten72892002, was übersetzt bedeutet. Normal pregnancy

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

Das folgende Beispiel zeigt, wie eine GET Anfrage für den DocumentReferenceRessourcentyp für Patient (s) erstellt wird, bei denen eine Streptokokken-Diagnose gestellt wurde und denen auch Amoxicillin verschrieben wurde.

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

Verwenden Sie das folgende Beispiel, um eine GET Anfrage für den Ressourcentyp zu stellen. Location Mit der folgenden Suche werden Standorte in Ihrem HealthLake Datenspeicher gefunden, die den Stadtnamen Boston als Teil der Adresse enthalten.

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

Verwenden Sie das folgende Beispiel, um eine GET basierte Suchanfrage für den ObservationRessourcentyp zu stellen. Diese Suche verwendet den value-concept Suchparameter, um nach medizinischem Code zu suchen266919005, was übersetzt bedeutet. Never smoker

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