

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
<a name="searching-fhir-resources-get"></a>

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](reference-fhir-search-parameters.md).

**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](searching-fhir-resources-post.md).

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](managing-data-stores-describe.md).

1. 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](reference-fhir-resource-types.md). 

1. 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](reference-fhir-search-parameters.md) 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]}}
   ```

1. Senden Sie die `GET` Anfrage entweder mit [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 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 [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)Datentyp.

   ```
   {
       "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](reference-smart-on-fhir-oauth-scopes.md).

------
#### [ 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](https://console.aws.amazon.com/healthlake/home#/crud)“ 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 Sie`Search with GET`.
   + **Ressourcentyp** — Wählen Sie den [FHIR-Ressourcentyp](reference-fhir-resource-types.md) aus, nach dem gesucht werden soll.
   + **Suchparameter** — Wählen Sie einen [Suchparameter](reference-fhir-search-parameters.md) 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
<a name="searching-fhir-resources-get-examples"></a>

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](reference-fhir-search-parameters.md).

------
#### [ Patient (age) ]

Obwohl das Alter in FHIR kein definierter Ressourcentyp ist, wird es als Element im Ressourcentyp erfasst. [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html) Verwenden Sie das folgende Beispiel, um eine auf [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html)Ressourcentypen `GET` basierende Suchanfrage zu stellen, indem Sie das Element [BirthDate](https://hl7.org/fhir/R4/patient-definitions.html#Patient.birthDate) und den `eq` [Suchkomparator](reference-fhir-search-parameters.md#search-comparators) 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 [https://hl7.org/fhir/R4/condition.html](https://hl7.org/fhir/R4/condition.html)Ressourcentyp zu stellen. Bei der Suche werden Bedingungen in Ihrem HealthLake Datenspeicher gefunden, die den medizinischen Code von SNOMED enthalten`72892002`, 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 [https://hl7.org/fhir/R4/documentreference.html](https://hl7.org/fhir/R4/documentreference.html)Ressourcentyp 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. [https://hl7.org/fhir/R4/location.html](https://hl7.org/fhir/R4/location.html) 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 [https://hl7.org/fhir/R4/observation.html](https://hl7.org/fhir/R4/observation.html)Ressourcentyp zu stellen. Diese Suche verwendet den `value-concept` [Suchparameter](reference-fhir-search-parameters.md), um nach medizinischem Code zu suchen`266919005`, was übersetzt bedeutet. `Never smoker`

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

------